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INTRO (1) 


11UNIX 


INTRO (1) 


NAME 

intro — introduction to commands 


DESCRIPTION 

This section describes publicly accessible commands in alphabetic order. 
Certain distinctions of purpose are made in the headings: 


(l) Commands of general utility. 

(1C) Commands for communication with other systems. 

(1G) Commands used primarily for graphics and computer-aided 
design. 

System maintenance commands formerly in the category 1M have been 
moved to section 8. 


SEE ALSO 

Section (6) for computer games. 

Section (8) for system maintenance programs. 

How to get started, in the Introduction. 


Upon termination each command returns two bytes of status, one sup¬ 
plied by the system giving the cause for termination, and (in the case of 
•normal’ termination) one supplied by the program, see wait and exit( 2). 
The former byte is 0 for normal termination, the latter is customarily 0 
for successful execution, nonzero to indicate troubles such as erroneous 
parameters, bad or inaccessible data, or other inability to cope with the 
task at hand. It is called variously 'exit code*, ‘exit status’ or ‘return 
code', and is described only where special conventions are involved. 
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Section 1 


Introduction 


1. Introduction 

MUNIX - Version Vl.5 is available in a field test version since February 
1984. This release is called HUNK VI .5/01. The version which will be 
released to the customer will be called HUNK Vl.5/02. These releases 
will bring along quite a few new features and enhancements to the pre¬ 
vious versions of HUNK. 

Apart from new commands these changes may not be too obvious to 
the innnocent user but are important for the system administrator. 
System adminstrators are urged to read this paper carefully. A good 
description of all system administrator tasks is given in a new docu¬ 
ment called "System Administrator 's Ouide". 

MUNIX release Vl.5/02 will be distributed automatically and free of 
charge to all users with a software maintenance contract. Those 
without one may obtain the new release on request. The distribution 
set of Vl.5/02 includes a new set of documentation. 

These release notes are part of the distribution kit. 

Part of the release notes, do only apply to those customers updating 
from previous MUNK versions to the current MUNIX version. The dis¬ 
tribution kit includes the following parts: 

a) Software on magnetic tape (800 bpi or 1600 bpi), floppies or 
streamer cartridges. 

b) Ducumentaion kit consisting of the following manuals: 

• MUNK la (commands) 

• MUNK lb (chapter 2 - 8) 

• MUNK II 

• MUNK III 

A paper called "Setting up MUNK Vl.5" is part of HUNK ID. 
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2. New Features of MUNDC Vl .5 

HUNK version 1.5 contains most of the new features and programs of 
AT&T UNK System V. Here are the major new features: 

a) New file systems using a block size of IK Byte 

b) New device drivers: 

- New terminal driver which provides many settable parameters 

- A device driver for the TS magtape 

- Ethernet driver 

- Driver for the CADMUS 2200 bitmap terminal 

c) New maximum program size 

d) New commands, system calls and C library functions 

e) Support for IEEE double precision floating point arithmetic (64 
bit) via: 

- Software 

- PCS floating point processor 

f) A set of hardware test programs 

g) Support of the on-board, battery supplied clock 

h) Accounting and systems statistics package 

i) News Package 

k) New Games 

l) Revised documentation 






Releasenotes 


HUNK Vl.5/02 


PCS GmbH 


Section 2.1 


New file system 


2.1. New file system 

The file system used with HUNK Vl.5/01 is that of AT&T UNK System 
V. This allows the use of two different block sizes - 512 bytes per block 
(size of previous versions) and 1 K bytes per block. It is up to the user 
(system administrator) to specify the desired block size when initializ¬ 
ing a new file system using the /etc/mkfs command. The larger block 
size has the advantage of better performance but will result in more 
blocks allocated to small files due to the fact that disc space is allo¬ 
cated to files in a multiple of the basic block size. When a file system is 
mounted, the block size of the volume is known by the system. 

It is possible to use 512 byte file systems and IK byte systems 
together, however only one size may be used on a single file system. 

The blocksize of a file system residing on the device xxx may be 
obtained via 
/elc/labelit /dev/xxx 

The performance improvements of a IK file system over a 512 byte file 
system differs according to file sizes and access frequencies. An 
improvement of 25% should be a fair guess. 

To take full advantage of the IK file system, the following steps must 
be taken: 

• save all old files which should be retained to a backup medium 
(tape, streamer or floppy) 

• initialize the file system using the /etc/mkfs command 

• restore the preserved files 

There are two versions of the mkfs command: 

/etc/mkfs which will initialize a file system using IK byte blocks 

/etc/mkfs.lb which will initialize a file system using 512 byte blocks 

The block size of the root file system as distributed is currently 512 
bytes. 

File system fragmentation may result in a decrease of performance 
(this fact is independent of the block size used). A new command 
dcopy (see DCOPY (8)) allows to reorganize a file system (trying to 
copy all data blocks of a file into contiguous disk blocks). This may in 
some cases speed up file data access by a factor of 2 ! 

While reorganizing the file system, it must not be mounted. 
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2.2. New Device Drivers 


MUNDC 1.5 contains some improved and enhanced device drivers along 
with new drivers. Detailed information concerning these new drivers is 
found at appropriate device description found in MUNDC manual 
chapter 4. The following device drivers are currently available and 
part of the distribution kit: 


bbp 


bip 

dz 

dl 

dh 


dqs 

hk 

hk2 

hi 

hp 

kl 

kmem 

Ibp 


IP 

mem 

null 

ot 

ox 

rk 


basic block port interface used with Ethernet. 

Currently only the 3-COM ethernet controller 
is supportet. 

The user device name is /dev/bbpn. 
driver for the CADMUS 2200 Bitmap display 

DZ-11 asynchronous serial line interface (providing 
4 or 8 serial lines including modem control) per 
controller. The user’s device name is /dev/ttyn. 

driver for DL-llE interface. The user’s device name is 
/dev/ttyn. 

DH-11 multiplexer (real DH-11 interface or MUX-KE 
emulation) providing for up to 16 serial lines per 
controller. The user’s device name is /dev/ttyn. 

driver for BSC-KE. This interface is used to emulate 
a RJE station on an IBM using the 360-20 procedure. 

device driver for RK06 and RK07 disk (emulation) 
device driver for second RK06 and RK07 disks controller 
device driver for second RL01 /RL02 controller 
device driver for RP04, RP05, RM02, RM03 disks 

device driver for DL-11J asynchronous serial lines. 

The user’s device name is /dev/ttyn. 

access to logical memory image (pseudo driver) 

The LBP-10 may be used for high quality output 
(graphic as well as text). Output to this device 
is produced by the following programs: 
lcat, ltrofT, laso, lplot (optional software). 

parallel line printer interface (LPV-ll) 

(up to two interfaces) 

access to memory image (pseudo driver) 

null device. All output to this device is discarded. 

On input it will always return <E0F> (pseudo driver). 

TM 503, TM 603, TM 703 et. al. disk drives 
(winchester drives) 

TM 100-4 floppy disk driver 
driver for RK05 disks 
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Hew Device Drivers 


rl driver for RL01 and RL02 type disks (also used with the 

10 MByte and 20 MByte winchester disks used in 
CADMUS 9210 and 9212). 

rm driver for RM02, RM03, RM05 disks 

rx driver for RX01, RX02, and RX03 floppy disks (up to two 

controllers are supported) 

sbp simplified block port interface. This is an addition 

to the standard UNIX IPC (inter process communication) 
facilities. 

si driver for multi-function board terminal interface 

st SCTll cassette streamer interface 

tm TM-11 and TU-10 magnetic tape interface 

ts TS-11 magnetic tape interface. The user’s device name 

is /dev/mmn. 

tty general terminal interface. It is linked to the user’s 

terminal of the user, whichever it may be. 

ttyn general terminal interface. It’s description is found 

under " TERMIO (4) ” 

vp Versatec printer-plotter (V80). This may also be used 

as an output device for troff (vtroff, vcat) 

(optional software). 


2.2.1. New Terminal Driver 

The terminal driver now distributed with Version 1.5 is the full termi¬ 
nal driver of UNIX system V. It contains far more features compared to 
previous terminal drivers: more parameters (e.g., the keys inter¬ 
rupt^ <quit>, <erase> and <kill>, may now all be set by the user using 
ioctl from a program or the stty-command. 

More information concerning the capabilities of the new terminal 
driver are found in termio (4) and stty (l). Full modem support is pro¬ 
vided for the DZV-11 interface (optional multiplexer interface with 4 
serial lines on a quad-wide Q-bus-board) and DH-11 interfaces with DM 
(the MUX-KE interface, standard with the CADMUS 9230 and CADMUS 
9212, has no modem control) and DL-11E. 


2.2.2. TS-11 Magtape Driver 

DEC’S new interface for low cost magnetic tape drivers is a controller 
called TS-11. There are second source controllers on the market emu¬ 
lating this interface. Many different tape drives are supported by these 
controllers (e.g. the CDC 9-track streamer tapes and the CYBER 9- 
track streamer tapes). The interface should be capable of using 22 
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address bits for DMA (e.g., the EMULEX TC02 controller). 

Currently the TS interface is not supported by the hardware bootstrap 
minitor ! For this reason it may not be used as distribution media for 
the root device. The user name of the tape is /dev/mtn. 


2.2.3. Ethernet Driver 

The Ethernet driver allows a very fast communication to other MUNDC 
systems using an ethernet interface. Currently only the 3-COM Ether¬ 
net interface (it is optional; consits of 3 dual wide Q-bus-boards) is 
supported. 

Communication to other systems is usually done using the Newcastle 
Connection software (an optional software package). A full description 
of the Ethernet installation is given in the Newcastle Connection 
Installation Guide disributed with the Newcastle Connection package. 


2.2.4. Bitmap Driver 

CADMUS 2200 is a high resolution (1024 x 1024) memory mapped black 
and white raster display using it’s own MC68000 processor for the gen¬ 
eration of picture elements (e.g. characters, lines, circles, area filling). 
An optional mouse is supported as a graphic input device. The monitor 
has a 17 inch screen. This display may be used as a terminal as well as 
a sophisticated graphic display. 

The terminal can emulate a restricted VT100/VT52 and (optional) Tek¬ 
tronix 4014. Further terminal emulations, though not yet available 
with MUNIX version 1.5, may be loaded (by software) later. A tablet may 
be connected soon. 

A description of how to set up the Bitmap software is part of the Bit¬ 
map distribution kit. 
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Maximum Program Size 



2.3. Maximum Program Size 

Previous versions of MUNIX restricted the program size to a maximum 
of 3MB per process, i.e. a maximum of 1 Megabyte for the text segment 
(code), the data segment and the stack segment each. This limit has 
been removed. With MUNIX version 1.5 the limits are a maximum of 9 M 
byte per process where data and stack may take up to 7 M byte. 

These are very theoretical limits since the program must still fit into 
the available free main memory which curently may be configured up 
to a 4 Megabyte capacity. The floating point processor will use 64 K 
byte of main memory address space while each CADMUS 2200 Bitmap 
station will require 256 K byte of address space. Thus a system 
configured to have 4 Bitmap stations (this feature is not yet sup¬ 
ported) may have only 3M byte of main memory (minus 64 K byte if the 
FPP81 floating point processor is used)! 


2.4. MC68000 Assembler a68 

The MC68000 assembler used with previous versions was called as. This 
assebler is still part of the Vl.5 basic MUNIX distribution kit, but it will 
not be distributed with future releases. It will be replaced by an 
MC68000 assembler called a68. The latter is much faster. The a68 will 
be the new standard assembler and is already part of the MUNIX distri¬ 
bution Vl.5. We strongly recommend the use of a68. 

Warning: The new assembler a68 is not compatible with as ! 
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2.5. New Commands 


This chapter provides a list of the new commands with version Vl.5. A 
complete list of all commands available for MUNDC is now part of the 
documentation set. The following list contains only those commands 
which are new to the basic MUNDC package. Those commands which are 
described in chapter 8 are marked (8). 


a68 

acctcom 

bcopy 

bfs 

bs 

check 

checknews 

chroot 

cpp 

cut 

create 

cref 

d 

dcopy 

dircmp 

efl 

expire 

ff 

file save 
fsba 


fsck 

dfsck 

fsdb 

fuser 

getopt 

id 

inews 

killall 

line 

logname 

look 


MC68000 assembler 
search and print process accounting 
interactive block copy (8) 
big file scanner. Similar to ed for very big files, 
a compiler/interpreter for a language with BASIC 
and SNOBOL constructs 
disk checking and formatting (8) 
check to see if user has news 
change root directory for a command (8) 
the C compiler preprocessor is now documented 
cut out selected fields of each line of a file 
"create a file" is now documented 
. "make cross reference listing" is now documented 
text data base funktion 

copy file system and reorganize it to achieve 
better performance (8) 
compare two directories 

FORTRAN preprocessor (was not yet documented) 
remove outdated news articles 
list file names and statistics for a file system 
/etc/filesave is one of several shell scripts to do 
a daily or weekly UNIX file system backup 
file system block analyser. It determines the number 
of extra 512 byte blocks needed to increase the 
logical block size of a file system from 512 bytes 
to 1 K bytes (8) 

the fsck command checks file systems with 512 
bytes or 1 K byte block size (8) 
allows two fscks to run simultaneously (8) 
interactive file system debuger (8) 

/etc/fuser identifies processes using a file (8) 
parse command options 
print user and group IDs and names 
submit new article to USENET 

/etc/killall will kill all processes not directly related 
to the shut down procedure (8) 
read one line from standard input and write it to 
standard output 

get login name (contained in SLOGNAME) 
find lines in a sorted list 
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New Commands 


lpclri 

mkfs 

mkfs.lb 

mm 

mmcheck 

mint 

mvdir 

news 

notes 

paste 

P6 

pn 

postnews 

prep 

readnews 

recnews 

regcmp 

sag 

sar 

setmnt 

timex 

unamc 

xargs 


set options on the parallel line printer 

fsck is now the new version, generating a IK byte 

file system 

fsck is the version of mkfs that will generate a 
512 byte block size file system 

print out document formatted with the mm macros 
check usage of mm macros and eqn delimiters 
format text using the mm makro set. troff is used 
as formatter. 

renames a directory (super user only) (8) 
print news items 
notesfile utility programs 

merge same lines of several files or subsequent lines 
of one file 

simple paginator for text files 

like pg. but does not erase the screen 

submit news articles 

prepare text for statistical processing 

read news article 

receive unprocessed articles via mail 
regular expression compile 

plot system activity graph (not yet fully tested) 
system activity reporter 

/etc/setmnt creates the /etc/mnttab (mount table) 
file (8) 

time a command; report process data and system 
activity 

print name of current user 

construct argument list and execute command 


2.6. New System Calls 

There are new system calls primarily taken from AT&T UNIX System V. 
A detailed description of these calls are found in chapter 2 of the 
MUNIX manual. The new calls are: 


chroot 

"change root" is now documented 

fcntl 

file control. This call was part of the previous releases 
but is now documented. 

hertz 

get the line frequency of the current machine. 

This call is MUNIX specific. 

long 

system calls modified for long arguments. These calls 
are MUNIX specific calls not found with other 

plock 

UNIX systems. 

lock process, text or data segment in main memory 
(replaces lock) 
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setpgrp 

times 

ulimit 

unaroe 

us tat 


set process group ID 

get process and child process times (extended 
return value now) 

get and set user limits (process file size limit, 

maximum possible break limit) 

get name or Ethernet identification of current 

UNIX system 

get file system statistics 


2.7. New C Library Functions 


While porting AT&T UNIX System V, we included several new functions 
into the standard C libraries. Some of the functions named below were 
already part of the previous MUNDC version, but they were not docu¬ 
mented yet. A description of the functions is found in chapter 3 of the 
MUNDC manual. 


a641 

abort 

acos 

aimag 

aint 

asm 

bip 

bool 

bsearch 

clock 

conjg 

conv 

ctermid 

curses 


cuserid 

d 

drand48 

erf 

fp(3) 

ftw 

ftype 

gamma 

gctarg 

getcwd 

gctopt 


convert between long and base-64 ASCII 

terminate FORTRAN program 

FORTRAN intrinsic function 

FORTRAN imaginary part of complex argument 

FORTRAN integer part of intrinsic function 

FORTRAN arcsine intrinsic function 

basic functions for the CADMUS 2200 bitmap display 

terminal 

FORTRAN bitwise boolean function 
binary search 
report CPU time used 

FORTRAN complex conjugate intrinsic function 

character transtation 

generate file name for terminal 

screen functions with "optimal" cursor motion. This 

library previously was part of the BERKELEY option. 

It will now be part of the standard distribution kit. 

character login name of the user 

text database functions 

generate uniformly distributed pseudo-random 
numbers 

error function and complementary error function 

floating point on the CADMUS (description only) 

walk through a file tree 

explicit FORTRAN type conversion 

log gamma function 

return FORTRAN command line argument 
get path name of current directory 
get option letter from argv 
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New C library Functions 


getut 

hsearch 

iargc 

index 

log 10 

logname 

long 

lsearch 

ma then- 

max 

mod 

putwent 

regex 

round 

sign 

signal 

ssignal 

tsearch 

tmpfile 

impnam 

trig 

ttyslot 


access utmp file entry 

manage hash search tables 

number of command-line arguments 

return location of FORTRAN substring 

FORTRAN common logarithmus intrinsic function 

login name of user 

standard procedures modified for long arguments 
linear search and update 

error handling function for mathematic functions 

FORTRAN maximum value functions 

FORTRAN remainder intrinsic function 

write passwrd file entry 

regular expression compile/execute 

FORTRAN nearest integer function 

FORTRAN transfer-of-sign intrinsic function 

specify FORTRAN action on receipt of a system signal 

software signals 

manage binary search tree 

create a temporary file 

create a name for a temporary file 

trigonometric functions 

find the slot in the utmp file of the current user 


2.8. IEEE Double Precision Floating Point Package 


With MUNIX VI.5 three different floating point packages are available: 

a) A fast single precision floating point package. 

This package is used as the default when floating point operations 
are used in programs. Our current MUNIX PASCAL supports only 
this package. If no floating point processor is available, this pack¬ 
age is preferred since it is much faster than the package b). The 
representation of floating point values used with this package 
however is not the same used with the packages b) and c)! A 32 bit 
floating point representation is used for single as well as double 
precision reals. To use this package, you have to use the option -f 
with the C compiler or F77 compiler. 

b) A software double precision floating point package using the data 
representation of the IEEE standard. 

This package provides double precision. As it is using instruction 
traps to emulate floating point operations, it is much slower than 
the packages n) and c). To use this package, you have to use the 
-fF-option when using the C or F77 compiler. 
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c) If the FPP81 hardware floating point processor is part of the sys¬ 
tem configuration (optional quad wide Q-bus board), this package 
may be used to achieve fast floating point operations. You must 
use the -fN-option when compiling C or F77 programs using float¬ 
ing point operations. 

A detailed information concerning floating point operations is found in 
fp(3). 


2.9. Hardware Test Programs 

A set of hardware test programs is now part of the distribution kit. 
Some of these programs were part of previous versions. However, no 
documentation was available for them. All hardware test programs are 
found in the directory /satest (stand alone test). These programs are: 


testmon 


bsctest 

check 

dztst 

fpptst 

lbptst 

memtst 

muxketst 

qetest 

scitst 

slutst 

t68030 

t68050 

tdma 


a testmonitor. This monitor will act as a general 
interface for the different test programs. 

, It should be started first. 

test program for BSC-KE (optional hardware) 
format new disks and check for bad blocks 
test for the DZVl 1. 

A short circuit connector is required! 

test for the FFP 81 floating point processor 

test for the LBP-10 laser beam printer 

test program to check main memory 

test for the MUX-KE. A short circuit connector is 

required! 

test for the 3-COM Ethernet controller 
SCSI adapter test 
SLS48/SLS88 test 

test for a QU 68000 or QU 68030 cpu 
test for a QU 68050 cpu 
DMA test program 


A more detailed documentation of this is given in the description of 
the testmonitor VI.2. The description of the monitor as well as a 
detailed description of the different tests are only available in German. 
An English description will follow. The manual pages for these com¬ 
mands are in English! 
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2.10. Command Lists 

There are several new lists now available. They should help the system 
manager to control his distribution set for completeness and to tailor 
his system accounting to his requirements. The latter may be an 
important task as the size of the distribution set has increased consid¬ 
erably. The distribution set for the single user version will already be 
stripped down. Refer to 3.4 for a complete list of omissions. The new 
lists are: 

a) A list of all MUNIX commands which names the command and gives 
its function. If a command is not part of the standard distribution 
kit, it is marked. The commands of this list are grouped according 
to their function. This list is found in the paper called "Current 
Commands". 

b) A list of file sets of the distribution set. For each file set its func¬ 
tion and storage requirement is given. 

c) A list of all files of a file set, together with their sizes are part of 
the distribution kit in the directory "/usr/local/filesets". 


2.11. Support of On-Board Battery Supplied Clock 

The on-board battery supplied clock of the QU 68030 and QU 68050 
CPU is now supported by MUNIX. The current date and time are set 
automatically at boot time and do not have to be set each time the 
system is started. For security reasons, however, MUNIX still asks you 
if the date and time it reads from the clock is correct. 

The battery supplied clock will only work for CPU’s produced after 
March 84. Old CPU versions may be upgraded by the PCS service. A 
CPU version 1 can not be upgraded at all! 

If you CPU does not have a battery supplied clock, the line time clock 
is used. 


2.12. Named Pipes 

A "normal pipe” has to be created dynamically by a process via the 
pipe system call and is used by its child processes for communication. 

"named pipes" on the contrary are created as filestore files and may 
have a permanent directory entry. The command "Is -1” will indicate a 
named pipe with a p in the first column. These files (pipes) may be 
used like ordinary files. The lenght of a write may however not exceed 
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5120 bytes. 

Named pipes may be used by processes which do not have a common 
ancestor. 

For more details refer to pipe (4). 


2.13. Accounting Package 

The UNIX System Accounting package supports a sophisticated 
accounting system to collect per-process resource utilization data, 
record connect sessions, monitor disk utilization and charge fees to 
specific logins. A set of C language programs and shell procedures are 
provided to reduce this accounting data into summary files and 
reports. 

A detailed description of the system accounting package will be found 
in MUNIX II ("UNIX System Activity Package"). 

Synopsis of the actions of the accounting system: 

At process termination, the UNIX system kernel records one 
record per process. 

The login and init programs record connect sessions, date 
changes, reboots and shutdowns. 

The disk utilization program "acctdusg” breaks down disk usage 
by login. 

Fees for file restores, etc., can be charged to specific logins with 
the "chargefee" shell procedure. 

Each day the "runacct" shell procedure is executed via "cron" to 
reduce accounting data and produce summary files and reports 
such as: 

• Usage statistics for each terminal line in the system 

• Total accounting file for the previous day 

• Total accounting file for a month 

• Daily command summary 

• Accumulation of the daily command summary for a month 

• Maintaining a record of the last time each login was used 

• Saving facilities 

The "monacct" procedure saves and restarts summary files, gen¬ 
erates a report, cleans up the sum directory and can be executed 
on a monthly or fiscal period basis. 
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Reports: 

V 

- Daily Report 

Contents: Reported period 

Total duration 
Terminal line no 
Minutes in use 

Percentage of total duration 
Number of accesses for a login session 
Number of logoffs 


Daily Usage Report 

Contents: User ID 

Login name 

CPU time of the user’s process 
KB segments of memory used per minute 
Real time the user was logged in 
Disk blocks used 

Number of processes invoked by the user 

Number of logins 

Widgets charged against the user 


Daily Command Summary 

Contents: Command name 

Number of invocations 
KB segments of memory used 
Total processing time 
Total real time 

Average of memory used per invocation 
Average of total processing time used per 
invocation 

Relative measure of the ratio of the system 
available to the system utilization 
Number of characters transferred by the 
read and write system calls 
Number of physical block reads and writes 


Monthly Total Command Summary 
Contents: see Daily Command Summary 

Last Login Report 

Contents: Date when a particular login was last used. 
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2.14. Macro Packages for nroff and troff 

There are a number of revised or new macro packages for nroff and 
troff. These packages are not fully supported but are distributed as a 
favor to our users. 

These are: 

mm 
ms 
roosd 

man 

mptx 
rav 
me 


2.15. Games 

To bring along still more, or at least a little bit of fun to the MUNIX 
user, new games are included into the distribution kit of Vl.5. You will 
find their description in MUNIX manual chapter 6. Special notice 
should be given to rogue. Since we installed it, more people have been 
seen working late at night! 


standard package of formatting macros 
package of formatting macros used with technical papers 
an adaptive macro package used in conjunction with 
the mm macros 

formatting macro package used to format the online 
manuals 

macro package for formatting a permuted index 
macro package for making view graphs 
comfortable formatting package using most instructions 
in a block oriented manner. 

This package is part of the optional Berkeley package. 
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3. Changes to Watch For 


Due to the integration of major parts of UNIX System V into MUND( Ver¬ 
sion 1.5, several changes took place which concern mainly the system 
manager. Since AT&T states that UNIX System V will be considered to 
be a (quasi) standard for the near future, we hope that future changes 
will not be as severe as the current changes. The system manager is 
urged to read chapter 8 of the MUNIX manual very carefully. 


3.1. System Information Files and Command Procedures 

When AT&T System V was introduced, the names as well as the format 
of several system information files changed. You will find the format of 
the different files in chapter 5 of the MUNIX manual. The following list 
names the most important system information files, which are found in 
the directory /etc : 


format 

old name: new name: changed? function: 


fstab 

checklist 

yes 

ddate 

ddate 

no 

ttytype 

gettydefs 

yes 

group 

group 

no 

ttys 

inittab 

yes 


issue 

new 

keycap 

keycap 

revised 

motd 

motd 

no 

mtab 

mnttab 

yes 

passwd 

passwd 

no 

termcap 

termcap 

no 

utmp 

utmp 

yes 

wtmp 

wtmp 

yes 


list of all files to be checked 
by /etc/fsck if no parame¬ 
ter is specified 
history for dump 
speed and terminal settings 
used by getty 
names of group members 
script for init process 
identification to be printed 
as a login prompt 
keyboard capability data 
base (used by med) 
message of the day. Send to 
all users after login 
table of mounted devices 
user names, their password, 
uid, gid, login directory, 
program 

description of terminal types 
holds user and accounting 
information for commands 
who, write, login 
holds user and accounting 
information as a history 
data 
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The following list names the command procedures of the directory 
/etc: * 


bcheckrc 
check all 
dumpall 

dumpcpio 

install 

mvdir 

newconf 

profile 

rc 

tape save 
whatconf 


check for correct date and check file system 
example command procedure to check all file systems 
example procedure to do a full or an incremental 
file dump using dump 

example procedure to do a full or incremental dump 
using cpio 

.searches for an executable file and changes the old 
file by the new one using the same file mode 
move a directory (connect it to another branch 
of the file tree) 

generate a new unix system. The new system will be 
/nunix. 

shell script, executed for all users after login 
shell script, executed when entering multi-user-mode 
volcopy backup to tape 

tell the generated configuration of a unix system 


3.2. Changes of Command Parameters 

UNIX System V brought along quite a few new options to standard com¬ 
mands. Some old options were discarded in favour of new ones. We 
reimplemented the -n option of the echo command. Please let us know 
if you encounter any serious problems. 


3.3. Single and Multi User Versions 

Up to MUNIX 1.4/06 single and multi-user distribution kits were virtu¬ 
ally the same. Only the learn files and online manuals were omitted 
from the single user version. Due to the fact that the required disk 
space increased tremendously with MUNIX VI.5, this is no longer rea¬ 
sonable since single-user versions are currently mainly distributed 
with 10 or 20 M byte disks using 5 1/4" floppies for backup. With MUNIX 
Vl.5 the single user distribution will not contain: 


accounting package (0.3 M byte) 
online documentation (2.7 M byte) 
trofl package (4.4 M byte) 
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user distribution kit at a low price since the distribution media is 
charged separately. The packages which are not part of the single user 
distribution kit may be ordered seperately for a handling charge plus 
the cost of the distribution media. 


3.4. English and German Versions 

There are two versions of the programs nrofT and trofl. The standard 
version is the one which will do hyphenation according to the Ameri¬ 
can (English) language. The versions which do it according to the Ger¬ 
man syntax are nrofTd and troffd. 

You must include them into your command files (c.g. 1 trofl command) 
if you want to use them! 


3.5. Versions of Stand Alone Programs 

Stand alone programs which were formerly found in the directory /sa 
are not yet able to differentiate between a 512 byte and a IK byte file 
system (see 2.1). For this reason there are now two sets of stand alone 
programs: 

one to be used with a 512 byte file system. These programs are 
found in the directory "/sal". 

one to be used with a IK byte file system. These programs are 
found in the directory "/sa2”. 

You should take care to use the correct version of a stand alone pro¬ 
gram. The root file system is distributed (using volcopy format) for a 
512 byte file system. We recommend to use a block size of IK for all 
other file systems. 

There is no special documentation for the stand alone versions of 
those programms where a online as well as a stand alone version is 
available. This will be corrected with a later release. 
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3.6. MUNK Manual Chapter 8 

Chapter 8 of the MUNK manual now contains all programs used by the 
system administrator. The system administrator should read this 
chapter very carefully. 


3.7. Omissions 

The following files and commands are no longer available or supported. 
If you want to use them furthermor, you should save them from the 
previous MUNK version. 


enroll 

icheck 

iostat 

learn 


lock 

mkconf 

move 

pubindex 

rofl 

tmctrl, tmskip 
tP 

xget 

xsend 


this command was never implemented 
use fsck 

this sytem call was never implemented 

learn is neither part of UNK System III nor System V. 

So the learn files are outdated. 

For this reason we removed them. 

this system call is replaced by plock 

replaced by newconf (/etc) 

use mvdir instead. This does only a link! 

this command was never implemented 

use nroff or troff 

use tm instead 

use tar or cpio 

this command was never implemented 
this command was never implemented 
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4. Known Bugs and Problems 

According to our tests. Vl.5 is upward compatible relative to Vl.4/06. 
Therefore you don’t have to recompile or modify your old programs in 
order to run them with MUNIX Vl.5. Due to changes of the read and 
write system calls, programs linked with the library liblc.a ( Vl.4/06 or 
later versions) will no longer run with previous versions! 

We will solve this problem by offering a small library including the old 
versions of read and write. This library is available on request for a 
handling charge. 
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We advise you to immediately complete this list with the upgrades and to fill the 
enclosed documents in your MUNIX binders and to remove the outdated docu¬ 


ments as required. 


Software 

Version No. 1 

Date 

Remarks 

MUNIX 

1.5/01 

03.84 

delivered documentation 



















• 








MED 

V 3.0 

03.84 

delivered documentation 







Berkeley 

V 1.1 

22.04.83 

delivered documentation 







PASCAL 

V 2.2 

9.09.83 

delivered documentation 






• 
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HOW TO GET STARTED 

This discussion provides the basic information you need to get started on UNIX: 
how to log in and log out. how to communicate through your terminal, and how 
to run a program. (See UNIX for Beginners by B. W. Kernighan for a more com¬ 
plete introduction to the system.) 

Logging in: You must dial up UNIX from an appropriate terminal. UNIX supports 
full-duplex ASCII terminals. You must also have a valid user name, which may be 
obtained (together with the telephone number(s) of your UNIX system) from the 
administrator of your system. Common terminal speeds are 10, 15, 30, and 120 
characters per second (110, 150, 300, and 1,200 baud); occasionally, speeds of 
240, 480, and 960 characters per second (2,400, 4,800, and 9,600 baud) are also 
available. On some UNIX systems, there are separate telephone numbers for 
each available terminal speed, while on other systems several speeds may be 
served by a single telephone number. In the latter case, there is one "pre¬ 
ferred” speed; if you dial in from a terminal set to a different speed, you will be 
greeted by a string of meaningless characters (the login: message at the wrong 
speed). Keep hitting the "break” or ••attention" key until the login: message 
appears. Hard-wired terminals usually are set to the correct speed. 

Most terminals have a speed switch that should be set to the appropriate speed 
and a half-/full-duplex switch that should be set to full-duplex. When a connec¬ 
tion (at the speed of the terminal) has been established, the system types login: 
and you then type your user name followed by the "return” key. If you have a 
password (and you should!), the system asks for it. but does not print ("echo") 
it on the terminal. After you have logged in, the "return”, "new-line", and 
"line-feed" keys will give exactly the same result. 

It is important that you type your login name in lower case if possible; if you 
type upper-case letters, UNIX will assume that your terminal cannot generate 
lower-case letters and that you mean all subsequent upper-case input to be 
treated as lower case. When you have logged in successfully, the shell will type 
a S to you. (The shell is described below under How to run a program.) 

For more information, consult login(l) and getty(Q), which discuss the login 
sequence in more detail, and stty(l), which tells you how to describe the 
characteristics of your terminal to the system (profile ( 5) explains how to 
accomplish this last task automatically every time you log in). 

Logging out. There are two ways to log out: 

1. You can simply hang up the phone. 

2. You can log out by typing an end-of-file indication (ASCII EOT character, 
usually typed as "control-z") to the shell. The shell will terminate and 
the login: message will appear again. 

How to communicate through your terminal. When you type to UNIX, a gnome 
deep in the system is gathering your characters and saving them. These char¬ 
acters will not be given to a program until you type a "return” (or "new-line”), 
as described above in Logging in. 

UNIX terminal input/output is full-duplex. It has full read-ahead, which means 
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that you can type at any time, even while a program is typing at you. Of course, 
if you type during output, the output will have interspersed in it the input char¬ 
acters. However, whatever you type will be saved and interpreted in the correct 
sequence. There is a limit to the amount of read-ahead, but it is generous and 
not likely to be exceeded unless the system is in trouble. When the read-ahead 
limit is exceeded, the system throws away all the saved characters. 

On an input line from a terminal, the character ’’control-x" “kills” all the char¬ 
acters typed before it. The character ’’backspace” erases the last character 
typed. Successive uses of "backspace" will erase characters back to, but not 
beyond, the beginning of the line. These default erase and kill characters can 
be changed; see sffy(l). 

The ASCII DC3 (control-s) character can be used to temporarily stop output. It is 
useful with CRT terminals to prevent output from disappearing before it can be 
read. Output is resumed when a DCI (control-q) or a second DC3 (or any other 
character, for that matter) is typed. The DCI and DC3 characters are not 
passed to any other program when used in this manner. 

The character ’’control-c*' is not passed to programs, but instead generates an 
interrupt signal, just like the "break”, "interrupt”, or "attention" signal. This 
signal generally causes whatever program you are running to terminate. It is 
typically used to stop a long printout that you don’t want. However, programs 
can arrange either to ignore this signal altogether, or to be notified when it 
happens (instead of being terminated). The editor ed( 1), for example, catches 
interrupts and stops what if is doing, instead of terminating, so that an inter¬ 
rupt can be used to halt an editor printout without losing the file being edited. 

The quit signal is generated by typing the character ”control-y". It not only 
causes a running program to terminate, but also generates a file with the "core 
image” of the terminated process. Quit is useful for debugging. 

Besides adapting to the speed of the terminal, UNIX tries to be intelligent as to 
whether you have a terminal with the "new-line” function, or whether it must 
be simulated with a "carriage-return" and "line-feed’’ pair. In the latter case, 
all input “carriage-return" characters are changed to “line-feed” characters 
(the standard line delimiter), and a "carriage-return" and "line-feed” pair is 
echoed to the terminal. If you get into the wrong mode, the sffy(l) command 
will rescue you. 

Tab characters are used freely in UNIX source programs. If your terminal does 
not have the tab function, you can arrange to have tab characters changed into 
spaces during output, and echoed as spaces during input. Again, the sffy(l) 
command will set or reset this mode. The system assumes that tabs are set 
every eight character positions. The fabs(l) command will set tab stops on 
your terminal, if that is possible. 

How to run a program. When you have successfully logged into UNIX, a program 
called the shell is listening to your terminal. The shell reads the lines you type, 
splits them into a command name and its arguments, and executes the com¬ 
mand. A command is simply an executable program. Normally, the shell looks 
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first in your current directory (see The current directory below) for a program 
with the given name, and if none is there, then in system directories. There is 
nothing special about system-provided commands except that they are kept in 
directories where the shell can find them. You can also keep commands in your 
own directories and arrange for the shell to find them there. 

The command name is the first word on on input line to the shell; the command 
and its arguments are separated from one another by space and/or tab charac¬ 
ters. 

When a program terminates, the shell will ordinarily regain control and type a S 
at you to indicate that it is ready for another command. The shell has many 
other capabilities, which are described in detail in sA(l). 

The current directory. UNIX has a file system arranged in a hierarchy of direc¬ 
tories. When the system administrator gave you a user name, he or she also 
created a directory for you (ordinarily with the same name as your user name, 
and known as your login or home directory). When you log in, that directory 
becomes your current or working directory, and any file name you type is by 
default assumed to be in that directory. Because you are the owner of this 
directory, you have full permissions to read, write, alter, or destroy its con¬ 
tents. Permissions to have your will with other directories and files will have 
been granted or denied to you by their respective owners, or by the system 
administrator. To change the current directory use cd(l). 

Path names. To refer to files not in the current directory, you must use a path 
name. Full path names begin with /, which is the name of the root directory of 
the whole file system. After the slash comes the name of each directory con¬ 
taining the next sub-directory (followed by a /), until finally the file name is 
reached (e.g., /usr/ae/filex refers to file filex in directory ae, while ae is itself a 
subdirectory of usr; usr springs directly from the root directory). See infro(2) 
for a formal definition of path name. 

If your current directory contains subdirectories, the path names of files 
therein begin with the name of the corresponding subdirectory (without a 
I prefixed /). Without important exception, a path name may be used anywhere a 
file name is required. 

Important commands that modify the contents of files are cp(l), mt/(l), and 
rm(l), which respectively copy, move (i.e., rename), and remove files. To find 
out the status of files or directories, use ls( 1). Use mkdir(l) for making direc¬ 
tories and rmdir(l) for destroying them. 

For a fuller discussion of the file system, see the references cited at the begin¬ 
ning of the INTRODUCTION above. It may also be useful to glance through Sec¬ 
tion 2 of this manual, which discusses system calls, even if you don't intend to 
deal with the system at that level. t 

Writing a program. To enter the text of a source program into a UNIX file, use 
ed(l). The four principal languages available under UNIX are C (see cc(l)), For¬ 
tran (see J77( 1)), bs (a compiler/interpreter in the spirit of Basic, see 6s(l)), 
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you can give the name of that file to the appropriate iangiiage proccwor a» an 
argument. Normally, the output of the language processor will be left n a^ file in 
thf current directory named a.out (if that output is precious, use mv(l) to give 
it a less vulnerable name). If the program is written in assembly ^^age, y d °£ 
will probably need to load with it library subroutines (see W(l)). Fortran and C 
call*t he loader automatically; programs written in bs(l) are interpreted and, 
therefore, do not need to be loaded. 

When vou have finally gone through this entire process without provoking any 
diagnosUc^the resulting program can b. run by giving its name to the .hell In 
response to the S prompt. 

If any execution (run-time) errors occur, you will need adb(l) ^ examine the 
of vour nroeram. On the VAX-11/780, a second debugger sd6(l), which 
allows you to step through C statements rather than assembler instructions, is 

available. 

Your programs can receive arguments from the command line just as system 
programs do; see exec(2). 

Text processing. Almost all text is entered through the editor ^(l). The com¬ 
mands most often used to write text on a terminal are caf(l). J>r(l), and 
nroff(l) The caf(l) command simply dumps ASCII text on the terminal, with no 
processing at all The j>r(l) command paginates the text, supplies headings, 
and has a facility for multi-column output. Nroff( 1) is an elaborate text forma - 
tmg program and requires careful forethought in entering both the text and 
the formatting commands into the input file; it produces output on a 
typewriter-like^terminal. Troff(\) is very similar to nro#(l). but produces its 
output on a phototypesetter (it was used to typeset this manual). There are 
several "macro" packages (especially the so-called mm P^ k age) th ? 
significantly case the effort required to use nroff{ 1) and fc-o^(l), Section 
entries fo/these packages indicate where you can find their detailed descrip¬ 
tions. 

Surprises. Certain commands provide inter-user communication. Even if you 
do not plan to use them, it would be well to learn something about them. 
because P someone else may aim them at you. To communicate with another user 
currently logged in. •u^ife(l) is used; mail(l) will leave a message whose pres¬ 
ence will be announced to another user when he or she next logs in. The 
corresponding entries in this manual also suggest how to respond to these two 
commands if you are their target. 

When you log in. a message-of-the-day may greet you before the first S. 
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We advise you to immediately complete this list with the upgrades and to fill the 
enclosed documents in your HUNDC binders and to remove the outdated docu¬ 
ments as required. 


Software 

Version No. 

Date 

Remarks 

HUNIX 

1.5/01 

03.84 

delivered documentation 







Typeset 

V1.0 

22.04.83 

delivered documentation 







sees 

V1.0 

22.04.83 

delivered documentation 







MED 

V 3.0 

03.84 

delivered documentation 







Berkeley 

Vl.l 

22.04.83 

delivered documentation 







PASCAL 

V2.2 

9.09.83 

delivered documentation 
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echo: echo arguments 
hcreate, hdestroy: manage hash search tables 
pack : packs or unpacks many flies 
system: issue a shell command 
construct argument list(s) and execute command 
ot. ox: TU 503/TU G03/TU 703 disk. TU 
hp: handle special functions of IIP 2640 and 
hp: handle special functions of HP 
13tol. ltol3: convert between 
diff3. 

tk: paginator for the Tektronix 
ot. ox: Til 
ot. ox: TU 503/TU 
ot. ox: TU 503/TU 603/TU 
fT7: Fortran 


value. 

utime: set file 

unite: enable a remote user to 
dcopy: copy file systems for optimal 
getutline. pututline. setutent, endutent, utmpname: 

acct: enable or disable process 
acctconl. acctcon2: connect-time 
acctprcl. acctprc2. process 
shutacct. startup, tumacct: shell procedures for 
acctdisk. acctdusg. accton, acctwtmp: overview of 
acctwtmp: overview of accounting and miscellaneous 

acct: per-process 
acctcom: search and print process 
acctmerg: merge or add total 
mclock: return Fortran time 
acctcms: command summary from per-process 
fwtmp, wtmpflx: manipulate connect 
runacct: run daily 
sa. accton: system 


accounting records. 

flle(»). 

acctconl, 

accounting and miscellaneous accounting command a 
and miscellaneous accounting commands, acctdisk, 

miscellaneous accounting/ acctdisk, acctdusg, 

sa, 

acctprcl, 

accounting commands, acctdisk. acctdusg, accton, 

sin, cos, tan, asin, 

killall: kill all 

sag: system 
sal. sa2, sadc: system 
sar. system 

sact: print current SCCS file editing 
time a command; report process data and system 

mosd: the OSOO 

information: table of interrupt vector and device 
/etc/map—port—eadr: table of ethemet 

yes: be repetitively 
basename: strip filename 
learn: computer 
argument, 
function, 
alarm: set a process's 

/etc/mkalias: create an 
which: locate a program file including 


.echo(l) 

. hsearch.hsearch(3C) 

<—> one.pack(l) 

.system(3S) 

. xargs: .xargs(l) 

100-4 floppy disk.ot(4) 

2521-senes terminals. .hp(l) 

2640 and 2621-series terminals.hp(l) 

3-byte integers and long integers.13tol(3C) 

3-way differential file comparison. .diff3(l) 

4014.tk(l) 

503/TU 603/TU 703 disk, TU 100-4 floppy disk. . . . ot(4) 

603/TU 703 disk. TU 100-4 floppy disk.ot(4) 

703 disk, TU 100*4 floppy disk..ot(4) 

77 compiler.f77( 1) 

a64l. 164a: convert between long and base-64 ASCII. . a64l(3C) 

a68: UIT assembler.a66(l) 

abort: generate an I0T fault.abort(3C) 

abort: terminate Fortran program..abort(3f) 

abs, iabs, dabs, cabs, sabs: Fortran absolute.abs(3f) 

abs: integer absolute value.. abs(3C) 

access and modiflcation times.utime(2) 

access: determine accessibility of a file.access(2) 

access the local system. .unite(6N) 

access time..dcopy(8) 

access utmp Ale entry, getutent, getutid.getut(3C) 

accounting.acct(2) 

accounting.acctcon(fl) 

accounting.acctprc(8) 

accounting, /prctmp, prdaily, prtacct, runacct, . . . acctsh(8) 

accounting and miscellaneous accounting commands. aect(8) 

accounting commands, acctdisk, acctdusg. accton. . acct(8) 

accounting file format..acct(5) 

accounting file(s).acctcom(l) 

accounting files..acctmerg(8) 

accounting...mclock(3f) 

accounting records..acctcms(8) 

accounting records..fwtmp(B) 

accounting.runacct(8) 

accounting.sa(8) 

acct: enable or disable process accounting.acct(2) 

acct: per-process accounting file format.acct(5) 

acctcms: command summary from per-process . . . ecctcms(8) 

acctcom: search and print process accounting . . . acctcom(l) 

acctconl. acctcon2: connect-time accounting. . . . acctcon(8) 

acctcon2: connect-time accounting.acctcon(8) 

acctdisk, acctdusg, accton, acctwtmp: overview of . . acct(8) 

acctdusg. accton, acctwtmp: overview of accounting acct(8) 

acctmerg: merge or add total accounting files. . . . acctmerg(S) 

accton. acctwtmp: overview of accounting and .... acct(6) 

accton: system accounting.sa(8) 

acctprcl. acctprc2: process accounting.acctprc(8) 

acctprc2: process accounting.acctprc(8) 

acctwtmp: overview of accounting and miscellaneous acct(8) 

acos, a tan. atan2: trigonometric functions.trig (3 U) 

acos, dacos: Fortran arccosine intrinsic function. . . acos(3f) 

active processes .killali(8) 

activity graph.sag(lC) 

activity report package.sar(8) 

activity reporter.»ar(l) 

activity.sact(l) 

activity, timex: .timex(l) 

adapter macro package for formatting documents. . mosd(7) 

adb: debugger.adb(l) 

addresses, configuration.conflnfo(4) 

addresses.ethmap(5N) 

admin: create and administer SCCS flies..admin(l) 

affirmative.ycs(l) 

affixes.basename(l) 

aided instruction about UNIX.leam(l) 

aimag. dimag: Fortran imaginary part of complex . . aimag(3f) 

aint, dint: Fortran integer part intrinsic.aint(3f) 

alarm clock.alarm(2) 

alarm: set a process's alarm clock.alarm(2) 

alias to a remote file.mkalias(8N) 

aliases and paths (esh only).which(l) 
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brk. sbrk: change data segment space 
malioc, free, re a Hoc, calloc: main memory 
intrinsic function, log. 
function, log 10. 

re nice: 
/etc/setugi: 
functions, max. maxO. 
max. maxO. amazO, maxi, 
functions, min. minO, 
min. minO. aminO. mini. 

functions, mod, 
lex: generator of lexical 
error, 
style : 

fsba: file system block 
boolean functions. 

functions, 
bed, ppt: convert to 


be: 

acos, dacos: Fortran 
ar. 

cpio: format of cpio 
ar. 

tar: tape 
cpio: copy file 
ranlib: convert 
asin. dasin: Fortran 
atan2, datan2: Fortran 
atan, datan: Fortran 
xargs: construct 
iarge: Number of command-line 
long: system calls modified for long 
long: standard procedures modified for long 
getopt: get option letter from 
be: arbitrary-precision 

news: USENET network news 
expr: evaluate arguments 

a64l, 164a: convert between long and base-64 

ascii: map of 

gmtime, asetime, tzset: convert date and time to 

atof, atoi, atol: convert 
ctime, localtime, gmtime, 
sin, cos. tan. 

help: 
a68: HIT 
as: 

assert: verify program 
setbuf: 
kl: KL-11 or DL-11 
dz. dh: DZ-ll.DH-11 
sin, cos. tan. asin. acos, 

function. 

sin, cos, tan. asin. acos, atan, 

atof, 
atof, atoi. 
notes, 
wait: 

ungetc: push character 

back: the game of 

fllesave, tape save: daily/weekly UNIX file system 

a64l, 164a: convert between long and 
vi: screen oriented (visual) display editor 
startrek: THE game 


allocation.brk(2) 

allocator.mal!oc(3C) 

a log. dlog. clog: Fortran natural logarithm.log(3f) 

aloglO. dlog 10. Fortran common logarithm intrinsic . Iogl0(3f) 
alter priority of running process by changing nice. . renice(6) 

alter user id of a UNIX server.setugi(8N) 

amaxO. maxi, amaxl. dmaxl: Fortran maximum-value max(3f) 
a max 1. d maxi: Fortran maximum-value functions. . max(3f) 

aminO. mini, aminl, dminl; Fortran minimum-value min(3f) 

aminl. dminl: Fortran minimum-value functions. . . min(3f) 

amod. dmod: Fortran remaindering intrinsic.mod(3f) 

analysis programs.lez(l > 

analyze and disperse compiler error messages. . . . error(l) 

analyze surface characteristics of a document. . . . style(l) 

analyzer.fsba(8) 

and. or. xor. not, lshift, rshift: Fortran bitwise .... booi(3f) 

anint, dnint, nint. idnint: Fortran nearest integer . . round(3f) 

antique media.bcd(6) 

a.out: format of programs and modules.ahdr(S) 

a.out: format of programs and modules.a.out(5) 

apropos: locate commands by keyword lookup. . . . apropos(l) 

ar. archive and library maintainer.ar(l) 

ar archive (library) file format.ar(5) 

arbitrary-precision arithmetic language.bc(l) 

arccosine intrinsic function.acos(3f) 

archive and library maintainer.ar(l) 

archive.cpio (3) 

archive (library) file format. .er(5) 

archiver.tar(l) 

archives in and out.cpio(l) 

archives to random libraries.ranlib(l) 

arcsine intrinsic function. .asin(3f) 

arctangent intrinsic function.atan2(3f) 

arctangent intrinsic function.atan(3f) 

argument list(s) and execute command.xargs(l) 

arguments.iarge (3 f) 

arguments.long,2) 

arguments.long(3C) 

argv.getopt(3C) 

arithmetic language.bc(l) 

arithmetic: provide drill in number facts.arithmetic(6) 

article, utility files. .news(5) 

as an expression.expr(l) 

as: assembler.as(l) 

ASCII.a64:(3C) 

ASCII character set.ascii(7) 

ASCII, ctime. localtime.ctime(3C) 

ascii: map of ASCII character set..ascii(7) 

ASCII to numbers..atof(3C) 

asetime, tzset: convert date and time to ASCII. . . . ctime(3C) 

asin. acos, atan. atan2: trigonometric functions. . . trig (3 U) 

asin, dasin: Fortran arcsine intrinsic function. .... asin(3f) 

ask for help.help(l) 

assembler.a68(l) 

assembler.as(l) 

assert: verify program assertion..assert(3X) 

assertion.assert (3X) 

assign buffering to a stream..setbuf(3S) 

asynchronous interface.kl(4) 

asynchronous multiplexers.dz(4) 

atan, atan2: trigonometric functions.trig(3tf) 

atan. datan: Fortran arctangent intrinsic function. . atan(3f) 

atan2. datan2: Fortran arctangent intrinsic.atan2(3f) 

atan2: trigonometric functions.trig(3U) 

atof, atoi. atoi: convert ASCII to numbers..atof(3C) 

atoi. atoi: convert ASCII to numbers..atof(3C) 

atoi: convert ASCII to numbers..atof(3C) 

autoseq, nfpipe, nfprint, nfstats: a news system. . . . notes(l) 

await completion of process..wait(l) 

awk: pattern scanning and processing language. . . . awk(l) 

back into input stream... ungetc(3S) 

back: the game of backgammon.back(6) 

backgammon.back(6) 

backgammon: the game.backgammon(6) 

backup.fllesave(8) 

banner, make long posters..banner(6) 

base-64 ASCIL.e64l(3C) 

based on ex.vi(l) 

based on the t.v. series.startrek(6) 
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bbp: 

sbp: SimpliAed 
Bip: 
basic: 


shell scripts, brc. 


lbp: LBP-10 Laser 
cb: C program 
vfont: font formats for the 
jO. jl. jn. yO. yl. yn; 

whereis: locate source, 
find the printable strings in a object, or other 
fread, fwrite: buffered 
b search: 

tsearch. tdelete, twalk: manage 
display. 

Bip: basic functions for 
Bip: basic functions for BIP. the PCS 
bip: CADMUS 

and. or. xor, not, lshift, rshift: Fortran 

bj: the game of 
fsba: file system 
bcopy: interactive 
bbp: Basic 
sbp: Simplified Basic 
sync: update the super 
df: report number of free disk 
df: report number of free disk 
and. or. sor, not, lshift, rshift: Fortran bitwise 

shell scripts. 

programs. 

fread, fwrite: 
stdio: standard 
setbuf: assign 
mknod: 
swab: swap 
cc, lcc: 
epp: the 
cb: 

indent: indent and format a 
lint: a 

xst r. extract strings from 
mkstr. create an error message file by massaging 

abs. iabs, dabs, 
fp: Floating Point on the 

dc: desk 
cal: print 

slat: data returned by stat system 

cu: 

malloc, free, realloc, 
intro: introduction to system 
link, unlink: exercise link and unlink system 

long: system 
ltroff, vtroff: trofl to the 
keycap: keyboard 
termcap: terminal 

catman: create the 
uncompact, ccat: compress and uncompress files, and 


compact, uncompact, 
cos, dcos. 


basename: strip filename affixes.basename(l) 

basic: Basic Interpreter.basic(l) 

Basic Block Port Interface.bbp(4) 

Basic Block Port Interface.»bp(4) 

basic functions for BIP. the PCS bitmap display. . . . b:p(3) 

Basic Interpreter.basic(l) 

bbp: Basic Block Port Interface.bbp(4) 

be: arbitrary-precision arithmetic language.bc(l) 

bed, ppt: convert to antique media.bcd(O) 

bcheckrc, rc, powerfail: system initialixation.brc(8) 

bcopy: interactive block copy.bcopy(O) 

bdiff: big diff.bdiff(l) 

Beam Printer Interface.lbp(4) 

beautifler.cb(l) 

Benson-Varian or Vcrsatcc.vfont(5) 

Bessel functions.bcsscl(3M) 

bfs: big Ale scanner.bfs(l) 

binary, and or manual for program. .whercis(l) 

binary, Ale. strings:.strings(l) 

binary input/output..fread(3S) 

binary search.bsearch(3C) 

binary search trees..Uearch(3C) 

Bip: basic functions for BIP, the PCS bitmap.bip(3) 

bip: CADMUS Bitmap Display.b:p(4) 

BIP. the PCS bitmap display.bip(3) 

bitmap display.bip(3) 

Bitmap Display.bip(4) 

bitwise boolean functions.bool(3f) 

bj: the game of black jack. .bj(fl) 

blackjack.bj(6) 

block analyser.fsba(8) 

block copy.bcopy(8) 

Block Port Interface.bbp(4) 

Block Port Interface.ibp(4) 

block.sync(8) 

blocks.dLf(l) 

blocks. 

boolean functions. .bool(3f) 

boot: standalone startup program..boot(8) 

brc, bcheckrc, rc. powerfail: system initialixation . . brc(8) 
brk. sbrk: change data segment space allocation. . . brk(2) 

bs: a compiler/interpreter for modcst-sized.bs(l) 

bsearch: binary search..bsearch(3C) 

buffered binary input/output. .fread(3S) 

buffered input/output package. . .stdio(3S) 

buffering to a stream..setbuf(3S) 

build special Ale.mknod(8) 

bytes. .swab(3C) 

C compiler.cc(l) 

C language preprocessor.cpp(l) 

C program beautiAer.cb(l) 

C program source.indent(l) 

C program veriAer.lint(l) 

C programs to implement shared strings.xartr(l) 

C source.mkstr(l) 

C stack frame layout..stack(5) 

cabs, zabs: Fortran absolute value.abs(3f) 

CADMUS.fp(3) 

cal: print calendar.cal(l) 

calculator.dc(l) 

calendar.cal(l) 

calendar: reminder service.calendar(l) 

call.■tat (7) 

call UNIX. .cu(lC) 

calloc: main memory allocator.malloc(3C) 

calls and error numbers. .intro(2) 

calls.link(8) 

calls modiAed for long arguments.long(2) 

CANON LBP or the Versatec V80.ltroff(l) 

capability data base.keycap(5) 

capability data base.termcap(5) 

cat: concatenate and print Ales.cat(l) 

cat Ales for the manuaL .catman(8) 

cat them compact,.•> • compact(l) 

catman: create the cat Ales for the manual.catman(8) 

cb: C program beautiAer.cb(l) 

cc, lcc: C compiler.cc(l) 

ccat: compress and uncompress Ales, and cat them . compact(l) 
ccos: Fortran cosine intrinsic function.cos(3f) 
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. cd: change working directory. cd(l) 

, , . , cdc: change the delta commentary of an SCCS delta. edef i » 

a ^*a Ule ' r * 'f*/ Ur, j 1 ** oor * ce 't fmod. fabs: floor, ceiling, remainder. floor(3H) 

floor, ceil, fmod, fab* floor, ceiling, remainder, abaolute value function*. . . flooKSU) 

. „ «*P- f e *P ; Fortran exponential intriniic function. . . . ! exp(3f) 

delta: make a delta (change) to an SCCS Ale. d«i««f 1 1 

remce: alter priority of running process by changing nice. .?*!"! 

, - P>P e: create a " interproces* channel.. 

n^™°‘ t, ,! ng ' db i e, f inpIx,dcmpl * lich “ r ' o^or: explicit Fortran type conversion.' Pidint.' .' .' ! ! ftv B ef3f) 

nulladm. prc.mp. prdaily, prtacct, runacct,/ chargefee. ckpacct. dodisk. lasUogin. monacct. . . . a/cuhfB) 

, , chair: change working directory. 

fsck, d.sck: flic system consistency check and interactive repair. * fsck(8) 

check: disk checking and formatting. * ! .* ! .* ! .* checkf01 

checknr. check nroff/troff flies.. checknrln 

checknews: check to see if user has nm . «... w 

mmchek: check usage of mm macros and cqn delimiters. * ! ! ! mmchekfl) 
checkall: faster flle system checking procedure. . . . checkall(8) 

troff. eqn, neqn. checkeq: format mathematical text for nroff or . eqn(l) * * 

checklist: list of flle systems processed by fsek. . . .* checklist^) 

. . . . , # v checknews: check to see if user has news. . . cheekn#w*/n 

newsrc: information flle for readnews(l) and checknews(l). ' ^eir ^ 

checknr: check nroff/troff flies. ‘ checknrm 

chfn: change full name of user.chfnfl) 

chown. chgrp: change owner or group. . chownMl 

Umes: get process and child process times..timesf2) 

wait: wait for child process to stop or terminate. ..!!!!.!! waitf2) ' 

chmod: change mode. ’ c hnuJ (i \ 

chmod: change mode of file. * c hmod(2) 

chown: change owner and group of a flle.chown(2) 

chown, chgrp: change owner or group.chownf 1) 

chroot: change root directory.chroot(2) 

. chroot: change root directory for a command 

pretmp, prdaily, prtacct, runacct,/ chargefee, ckpacct. dodisk. lastlogin. monacct, mdladm ! ! ! acctsh(Q) 
ispunct, ispnnt, lsgraph. iscntrl, isascii: classify characters, /iadigit. isalnum. isspace ct^fSCl 

uuclean: uucp spool directory clean-up.7T . . . * 

clear: clear terminal screen.‘ clear/1) 

clri: clear i-node. cM%) ' 

clear, clear terminal screen. * ciear/l) 

. , „ # . terror, feof, clearerr, flleno: stream status inquiries. ..!**' 

esh: a shell (command interpreter) with C-like syntax. 4 ' 3SJ 

alarm: set a process’s alarm clock. . 

cron: clock daemon.! ! ! ! . crZirfB) 

clock: rc P ort CPU Ume used.! . ciockf3C) 

log. alog. dlog. clog: Fortran natural logarithm intrinsic function. lorf3n 

close: close a flle descriptor.•. cl “^ f ox 

. , _ close: close a file* descrip tor. ’ closed 

fclose, fflush: close or flush a stream.. * fdoseraSl 

/etc/startnc. /etc/stopnc: starts up (closes down) the flle eerrer spawner.. * ' ‘ 

clri: clear i-node.| c w a) v J 

. A .. ... , emp: compare two flies. 

mt. lflx, idint. real, float, sngl, dble. cmplx, dcmplx, ichar. char, explicit Fortran type/ * ftVoefsn 

col: Alter reverse line feeds.col(l) * 

i j colcrt: Alter nroff output for CRT previewing. colcrt(l) 

log. dmesg: collect system diagnostic messages to form error . . dmesg(8) 

colrm: remove columns from a flle.colrmf l \ 

colrm: remove columns from a flle. colrmH) 

comb: combine SCCS deltas. ‘ ‘ comb/ll 

comb: combine SCCS deltasi.. comb(l) 

, . c °nxm: select or reject lines common to two sorted . commfll 

chroot: change root directory for a command... chrcSt/ai 

.... (command interpreter) with C-like syntax.* \ ! \ \ cshfl) 9 

test: condition evaluation command. testfil 

time: time a command...timefll 

getarg: return Fortran command-line argument. ‘ eetari/afl 

, . iarge: Number of command-line arguments. .! . iarec/afl * 

sw of accounting and rrusceUaneous accounting commands, acctdisk. acctduag. accton. acctwtmp: ‘ ! acctfSl 

install: install commands. * iMt _Swa\ 

intro: introduction to commands. .introfi 1 

i ede: change the delta commentary of an SCCS delta. .!!!!!!;.*.* ! cdcfl) 

log 10. alog 10. dlog 10: Fortran common logarithm intrinsic function. loelO/art 

comm select or reject lines common to two sorted flies..’ comm(l) 

u f er * compact list of users who are on the system. .... users(l) 

cat com P act - uncompact, ccat: compress and uncompress compact(l) 

dux: differential flle comparator. 1 ) V 7 

emp: compare two Ales..cmp(l) 

J scesdiff: compare two versions of an SCCS flle.sccsdifffl) 

diff3: 3-way differential flle comparison. diffSfll ' 

diremp: directory comparison.dircmpfl) 

regexp: regular expression compile and match routines.. ‘ regexp(7) 
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regcmp: regular expression 
regex, regcmp: regular expression 
cc, lcc: C 

error: analyze and disperse 
f77: Fortran 77 
pc: Pascal 
yacc: yet another 
b* a 

erf. erfc: error function and 
wait: await 

aimag. dimag: Fortran imaginary part of 
conjg. dconjg: Fortran 
compact, uncompact, ccat: 

learn: 

cat: 

test: 

newconf: generate 
vector and device addressea 
function. 

conjg. dconjg: Fortran complex 
fwtmp, wtmpftx: manipulate 
user and group id mappings for the Newcastle 
/etc/utah: neighbours known to the Newcastle 
acctconl. acctcon2: 
fsck. dfsck: file system 
rjestat: RJE status report and interactive status 

mkfa 

xarga 

derofl: remove nrofl/troff, tbl, and eqn 
Is. il. 1. lr. If. lx: list 
csplit: 
ioctl: 

. fcntl: file 

init, telinit: process 
fcntl: file 

uustat: uucp status inquiry and job 
vc: version 
tty: 
term: 

ecvt. fcvt: output 
cmplx, dcrnplx, ichar, char, explicit Fortran type 

units: 

scanf. fscanf. sscanf: formatted input 

dd: 
ranlib: 
atof. atoi. atol: 
13tol, ltol3: 
a04l. 164a: 

ctime, localtime, gmtime, asctime. txset: 

bed. ppt: 
dd: convert and 
bcopy: interactive block 
cpio: 
dcopy: 
volcopy, labelit: 
cp. In. mr. 

uucp. uulog, uuname: unix to unix 
uuto. uupick: public UNDC-to-UNDC file 

core: format of 
mem, kmem- 

functions. sin, 
function, 
sinh, 

cos, dcos, ccoa Fortran 
cosh, dcosh: Fortran hyperbolic 
sum: sum and 
wc: word 

cpio: format of 


clock: report 
craps: the game of 


crash - what to do when the system 


compile.regcmp(l) 

compile/execute.regex(3X) 

compiler.cc(l) 

compiler error messages.error(l) 

compiler.f77(l) 

compiler.. pc(l) 

compiler-compiler.yacc(l) 

compiler/interpreter for modest-sixed programs. . . bs(l) 

complementary error function..erf(3U) 

completion of process. .wait(l) 

complex argument.aimag(3f) 

complex conjugate intrinsic function.conjg(3f) 

compress and uncompress flies, and cat them. .... compact(l) 

computer aided instruction about UNIX.leam(l) 

concatenate and print fllea .cat(l) 

condition evaluation command.test(l) 

configuration file and reconflgure MUNDC.newconf(S) 

conflguration information: table of interrupt .... conflnfo(4) 
conjg, dconjg: Fortran complex conjugate intrinsic . conjg(3f) 

conjugate intrinsic function.conjg(3f) 

connect accounting records.fwtmp(6) 

Connection, /etc/pwmap. /etc/groupmap: .pwmap(5N) 

Connection.utab(5N) 

connect-time accounting.acctcon(S) 

consistency check and interactive repair.fsck(6) 

console.rjcstat(lC) 

construct a file system..mkfs(8) 

construct argument list(s) and execute command . . xargs(l) 

constructs. .derofl(l) 

contents of directory.l*(i) 

context split.csplit(l) 

control device.ioctl(2) 

control.fcntl(2) 

control initialisation.init(8) 

control optiona.fcntl (7) 

control.uustat(lC) 

control.vc(l) 

controlling terminal interface.tty(4) 

conventional names.. . . . . term(7) 

conversion.ecvt(3C) 

conversion, /iflx, idint. real, float, sngl, dble. .... ftype(3f) 

conversion program. .units(l) 

conversion.scanf(3S) 

convert and copy a file.dd(l) 

convert archives to random libraries. .ranlib(l) 

convert ASCII to numbera .atof(3C) 

convert between 3-byte integers and long integers. . 13to!(3C) 

convert between long and base-64 ASCII..a64l(3C>~ 

convert date and time to ASCII..ctime(3C) 

convert to antique media.bed(6) 

copy a file.dd(l) 

copy.bcopy(8) 

copy file archives in and out.cpio(l) 

copy file systems for optimal access time.dcopy(8) 

copy file systems with label checking.volcopy(6) 

copy, link or move flies.cp(l) 

copy.uucp(lC) 

copy.uuto(lC) 

core: format of core image file.core(5) 

core image file.core(5) 

core memory.mem(4) 

cos. dcos. ccoa Fortran cosine intrinsic function. . . cos(3f) 
cos, tan. asin. acoa a tan, atan2: trigonometric . . . trig (3 U) 
cosh, dcosh: Fortran hyperbolic cosine intrinsic . . . cosh(3f) 

cosh, tanh: hyperbolic functiona.sinh(3U) 

cosine intrinsic function.cos(3f) 

cosine intrinsic function.cosh(3f) 

count blocks in a file.sum(l) 

count..wc(l) 

cp, in, mv. copy, link or move flies.cp(l) 

cpio archive.cpio(S) 

cpio: copy Ale archives in and out.. . . cpio(l) 

cpio: format of cpio archive.cpio(S) 

epp: the C language preprocessor.cpp(l) 

CPU time used.clock(3C) 

crapa .craps(6) 

craps: the game of crapa.eraps(8) 

crash - what to do when the system crashea.craah(8) 

crashes.crash(8) 
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one. ere at: create a new ftle or rewrite an existing .... creat(2) 

umask: aet and «et Me creation maak. ..... .“"“" W 

cref: make croawreference listing. Cr * /o\ 

cron: clock daemon. . cr °" ( " ) 

cref: make croaa-reference listing. 

xref: croaa-reference listing.“TfliJ/,. 

colcrt: Mter nroff output for CRT previewing.' ,\ / 

more, page: Me peruaal filler for £™"^,; decod ,. * ! ! ! ! ! ! ! ! I ! ! crypt(l) 

crypt, setkey. encrypt: DES encryption. . ..crypt(3C) 

ayntax. cah: a aheU (command interpreter) with C-like .... 

locate. program Me including aliases a.£paU» ^trinaic 'function.' ! ! ! ! ! ! '. ! ’• -n(30 

aqrt. daqrt, c^rt: Fortran 1 ^uare root intrinsic function. .... •V-PO 

cun: create a tagi file...ciag*\»/ 

ctermid: generate Me name for terminal.ctermjd(3S) 

date and time to ASCIL ctime. locjltime. «mtime. optima. U«t: convert . . ctime(3C) 

hertx:,et the Un, frequency^ A. SC^eitini activii,: «ct(.) 

un.m..ethn.m.:«etn.me/eth«™«Wd.n^caU«of *. ! • ! • • • • ! • '• ! ’* *• ! ! ! 

ttyalot: find the VSS* 5ta«' M* • j '• jj..'- ^ •"‘"JfiP 

* motion, curses: screen function, with optimal curaor . . cur»**(3) 

curaea: acreen function, with "optimal" curaor motion. .* * ; * ] ; m iine(lCl 

apline: interpolate amooth cuaend(3S) 

file, cut: cut out selected fields of each line of a. 

cut: cut out selected fields of each line of a file.cut(l) 

d : text database functions. 

d: text database functions. • • ; • ..rjji-n 

abs. labs, dabs, cabs, sabs: Fortran absolute value. .abs(3f) 

acos, dacos: Fortran arccosine intrinsic function.acos(3f) 

# cron: clock daemon.Edfa?* 

lpd: line printer daemon. . ..runaeetffil 

runacct: run daily accounting.. .. 

fllesave. tapesave: daily /weekly UNIX file system backup. . 

asin. dasin: Fortran arcsine intrinsic function. .asm(3f) 

times: time a command; report process data and ayatem activity. 

dbadd: add entry to an Emacs data base. keycap(5) 

keycap: keyboard capability data base. - j .. dbmfaXl 

dbminit, fetch, storedelete. flrstkey. nextkey. data baae ^^°uUnea .! ! ! ! Slfy(l) 

unify relational data base system... 

termcap: terminal capability database..t»lock(2^ 

plock: lock process, text, or data in memory.SrofflY 

prof: display profile data...*. L-tm 

stat: data returned by stat system call . 

brk. sbrk: change data segment space allocation. Wtffl 

types: primitive system datatypes. .. ; 

19 d: text database functions.. 

d : text database functions.. 

Join: relational database operator. .•••••••;••• .* 

^ a tan. da tan: Fortran arctangent intrinsic function.atan(3f) 

atan2, datan2: Fortran arctangent intrinsic function. . . . atp2(3f) 
ctime, local time, gmtime. asctime.txsetconvert date and time to ASCIL .... . . • • • • * ; ; ; ; ; SJSflJ 

dote: pnnt and set the date. . • • V-’V-iliil. touchfll 

touch: update date last modified of a me.. d-t-m 1 

dblldd 1 ? add «U 7 to an Emcs data base. .* bad d(l) 

^'““iSSSilSiSS: ::<&> 

rune »• dcop J _? copy mc ay ate ms for optimal access time. . . dcopy(8) 

cos. dcos. ccos: Fortran cosine intrinsic function. C09 u}I?n 

function, cosh, dcosh: Fortran hyperbolic cosine intrinsic.cosher) 

dd: convert and copy a file. 

dump, ddate: incremental dump format. .*dbTl) 

fsdb: file lyrtra debugfer...l^nchlrf?) 

•rsaffsjsrss isrXTs.”s»^"^ :: • 

mmehek: cheek uaaga of mm macros and eqn “jlatp.n'ofaiu..' ! ! ! ! ! '. ! ! ! i ^(>) 

ede: change th« delta commentary of.nSCCS ^ (change) 's CC S Me.' ! i ! ! ! ^ i • • • • • 5eKa(l) 
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Permuted Index 


cdc: change the 
rmdel: remove a 

comb: combine SCCS 
mesg : permit or 
construct*, 
crjpt, setkey. encrypt: 

whatis: 
close: close a file 
dup: duplicate an open file 
dc: 
access: 
Ale: 

information: table of interrupt vector and 
whatconf: what 
fold: fold long lines for Anite width output 
ioctl: control 
devnm: 


«P. 


interactive repair, fsck. 

dz. 

dz. dh: DZ-11, 
dmesg. collect system 
ratfor. rational Fortran 
print wordy sentences, interactive thesaurus for 
interactive thesaurus for diction. 

bdifl: big 


sdifT: side-by-side 
difl: 

difl3: 3-way 
aimag. 

aint. 


dir: format of 
rm, rmdir : remove Ales or 
cd: change working 
chdir: change working 
chroot: change root 
uuclean: uucp spool 
dircmp: 
unlink: remove 
chroot: change root 
getcwd: get path-name of current working 
la, 11.1, lr, If, lx: list contents of 
mkdir: make a 
mvdir: move a 
pwd: working 
mknod: make a 
sect: enable or 

getty : set terminal type, modes, speed, and line 
df: report number of free 
df: report number of free 
check: 

hk: RK6U/RK06. RK07 moving-head 
hp: RP04/05/08, RM02/03 moving-head 
rxctrl: Aoppy 

ot, ox: TM 503/TM 603/TM 703 disk. TU 100-4 Aoppy 
rk : RK-11/RK03 or RK05 
rl. hi: RL01/RL02 moving-head 
rm: RM02/03/05 moving-head 
rx : RX01 or RX02 Aoppy 
ot. ox: TM 503/TM 603/TM 703 
du: summarize 
format: how to format 
mount, umount: mount and 
error analyze and 
Bip: basic functions for BIP, the PCS bitmap 
bip: CADMUS Bitmap 
vi: screen oriented (visual) 
prof: 

hypot: Euclidean 
srand46. seed46, lcong46: generate uniformly 

kh KL-11 or 


delta commentaryof an SCCS delta.cdc(l) 

delta from an SCCS Ale.rmdcl(l) 

delta: make a delta (change) to an SCCS Ale.delta(l) 

deltas.comb(l) 

deny messages.mesg(l) 

derofl: remove nroff/troff, tbl. and eqn.deroff(l) 

DES encryption.crypt(3C) 

describe what a command is.whatis(l) 

descriptor.close(2) 

descriptor.dup(2) 

desk calculator.dc(l) 

determine accessibility of a Ale.access(2) 

determine Ale type.Ale(l) 

device addresses, configuration .conflnfo(4) 

device drivers are in an unix kernel.whatconf(fi) 

device.fold(l) 

device.ioctl (2) 

device name.. devnm(8) 

devnm: device name.devnm(fl) 

dexp, cexp: Fortran exponential intrinsic function. . exp(3f) 

df: report number of free disk blocks.df(l) 

df; report number of free disk blocks.df(8) 

dfsck: Ale system consistency check and.fsck(8) 

dh: DZ-U. DH-11 asynchronous multiplexers.dz(4) 

DH-11 asynchronous multiplexers.dz(4) 

diagnostic messages to form error log.dmesg(6) 

dialect..ratio r(0 

diction, diction, explain: .diction(l) 

diction, explain: print wordy sentences.diction(l) 

difl.bdiff(l) 

difl: differential Ale comparator.difl(l) 

diff3: 3-way differential Ale comparison. .diff3(l) 

difference program..sdiff(l) 

differential Ale comparator.diff(l) 

differential Ale comparison..diff3(l) 

dimag: Fortran imaginary part of complex argument. aimag(3f) 

dint: Fortran integer part intrinsic function.aint(3f) 

dir. format of directories.dir(3) 

dircmp: directory comparison.dircmp(l) 

directories.dir(5) 

directories.rm(l) 

directory.cd(l) 

directory.chdir(2) 

directory.chroot(2) 

directory clean-up.uuclean(8) 

directory comparison. .dircmp(l) 

directory entry.unlink(2) 

directory for a command.chroot(8) 

directory.getcwd (3C) 

directory.MO 

directory.mkdir(0 

directory.mvdir(8) 

directory name.pwrd(l) 

directory, or a special or ordinary Ale.mknod(2) 

disable process accounting.acct(2) 

discipline.gettv(8) 

disk blocks.df(l) 

disk blocks.df(8) 

disk checking and formatting.check(8) 

disk.hk(4) 

disk.hp(4) 

disk manipulating program. .rxctrl(0 

disk.ot(4) 

disk.rk(4) 

disk.rl(4) 

disk.rm(4) 

disk.rx(4) 

disk. TM 100-4 floppy disk.©t(4) 

disk usage.du(l) 

disks.format(O) 

dismount Ale system..mount(8) 

disperse compiler error messages.error(l) 

display.bip(3) 

Display.bip(4) 

display editor based on ex.vi(l) 

display proflle data.prof(l) 

distance function.nypot(3M) 

distributed pseudo-random numbers. /Jrand48, . . . drand48(3C) 
DL-11 asynchronous interface.kl(4) 
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function, log. alog. dlog. clog: Fortran natural logarithm intrinsic .... kg(3f) 

function loglO. aloglO. dlog 10 : fortran common logarithm intrinsic.Iogl0(3rj 

max maxO. amaxO. maxl.amaxl. dmaxl: Fortran maximum-value functions. ..... R*s(3.) 

error log dmesg: collect system diagnostic messages to form . dmesg(8) 
min. minO. aminO. mini, aminl. dminl: Fortran minimum-value functions. . ..... min(3f) 
mod. amod. dmod: Fortran remaindering intrinsic functions. . . mod(3f) 
functions, anint, dnint. nint. idnint: Fortran nearest integer .round(3f) 

aivle analyze surface characteristics of a document. . . . . . . • • • • • ;. 

* 7 mni: print out documents formatted with the Ull macros. . 

M... in-r. EXES. SSTiiU. M&. "&L 

prdaily. prtacct. runacct./ chergefee. ckpacct. dodisk. laaUo*in. monacct. nulladm. prctmp.^= uh(8) 

w: who it on and what they are doing. • •.. 

whodo: who i* doing what. 

/etc /startnc?/* tc/stopn? startjup (closes Z2Sff* 

pandas. ::: SSSST 9 

arithmetic: provide driUin number facta. . . .. 

whatconf: what device driver, are :n an uiux kernel ....... .... . . whatconUBJ 

sign isign. dsign: Fortran transfer-of-sign intrinsic function. . sign(3f) 

* sin, dsin. csin: Fortran sine intrinsic function.sm(3f) 

sinh. dsinh: Fortran hyperbolic sine intrinsic function. . . tnh(3f) 

function, sqrt, dsqrt, csqrt: Fortran square root intrinsic. mMZn 

tan. dtan: Fortran tangent mtnnric function.tantar) 

function. tanh. dtanh: Fortran hyperbolic tangent intrinsic. to nh(3ir) 

du: summarize disk usage.® U UJ 

dump, ddate: incremental dump format..dump to) 

dump: incremental file system dump.^ • • ^.durrrafsl 

dump, ddate: incremental dump format. . . . . » • ♦ • .. A 

P dump, incremental file system dump. 

od : octal dump.SurrldirfBl 

dumpdir: print the names of files on a dump tape. ’.I.*.!!!!, xd(l) 

xd . hexadec*ma the names of flies on a dump tape. . . dumpdir(8) 

rogue: Exploring The Dungeons of Doom. •••*•*:; .' 

* Y dup: duplicate an open file descriptor.<|up(2) 

dup: duplicate an open file descriptor. • • • : ;. 

dz, dh: DZ-11, DH-11 asynchronous multiplexers. . . dz(4) 
dz. dh: DZ-11. DH-11 asynchronous multiplexers.d 2 ( 4 ) 

uucp: uucp installation made easy. ... 

echo: echo arguments. 

echo: echo arguments. 

ecrt, fcvt: output conversion.w 

ed. red: text editor.«<J(1) 

end. etext, edata: last locations in program..rV 

aacl: print current SCCS fUe editing activity.“, c A lu 

vi: acreen oriented (ritual) display editor baaed on ex."iAA 

ed, red: text editor.. 

ex: text editor.**}•' . 

med: screen editor. 

aed: stream editor... 

.et real user effective user, real group, and effective group IDs. /geteuid. getgid. getegid: . . . . getmd(2) 

xsssasa^J’J^ ss ?’ 

grep, egrep. fgrep: search a file for a pattern. * r9 y/*\ 

soelim: eliminate .so s from nrofl input. .soelimjl) 

emacs: a screen editor.i? 

dbadd: add entry to an Emacs data base.• • • • • • • * * * * 

unite: enable a remote user to access the local system. . . unite(8K) 

accu enable or disable process accounting. acct l*> 

crypt: encode/decode. 

crypt, setkey. encrypt: DES encryption.crypt(3C) 

crypt, setkey. encrypt: DES encryption. .. • • • ^ c v k ' (8) 

makekey: generate encryption key. • • 

7 end. etext. edata: last locations in program..end(3C) 

J£grj&&£S££2Z2i ::::: 

man. manprog: print entries in this manual. 

man: macros for formatting entries in th.a manual.™ (e ' 

rje: RJE (Remote Job Entry) to IBU. • • • .. . • • • • . . 

1 env: set environment for command execution.env(l) 

environ: user environment. ..environ^ 
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profile: setting up an 
environ: user 
env. set 
getenv. value for 
getenv; return Fortran 
eqnchar: special character definitions for 
derofT: remove nrofT/troA, tbl, and 
mmchek: check usage of mm macros and 
nrofl or trofl. 
neqn. 

srand46. seedlB, lcong48: generate/ drand48, 

function, 
function, erf, 
perror, sysLjerrlist. sys_nerr, 
message a 
erf, erfc: 

erf. erfc: error function and complementary 
dmesg: collect system diagnostic messages to form 

mkstr: create an 
error: analyse and disperse compiler 
perror. sys-errlist. sys-nerr, errno; system 
intro: introduction to system calls and 

math err: 

spell, spellin, spellout: And spelling 
setmnt: 

Newcastle Connection, /etc/pwmap, 


tables in a process, 
mappings for the Newcastle Connection. 


the file server spawner. 
server spawner. /etc/startnc, 
client. 
Connection, 
end, 

/etc/map-port—eadr. table of 
current UNIX system, unarr.e. 

hypot: 
expr. 
test: condition 

screen oriented (visual) display editor based on 

execute a file, 
ex eel, exeev, 
excel, exeev, execle, exeeve, 
execl. exeev, execle. exeeve. exeelp, execvp; 
xargx construct argument list(s) and 

at: 

enr. set environment for command 
sleep: suspend 
sleep: suspend 
monitor: prepare 
proftl: 

uux: unix to unix command 
file, execl, 
execl. exeev, execle, 
execl, exeev, execle. exeeve, exeelp, 
link, unlink: 

crest: create a new file or rewrite an 

exit. 

function. 

power, square root functions. 

expand, unexpand: 

versa. 

' thesaurus for diction, diction, 

float, sngl, dble, cmplx. dcmplx, ichar. char. 

rogue: 

frexp. ldexp, modf: split into mantissa and 
exp. dexp. cexp: Fortran 
functions, exp, log. log 10, pow, sqrt: 

regexp: regular 
regemp: regular 


environment at login time.proflle(5) 

environment. .environ(7) 

environment for command execution. .env(i) 

environment name.getenv(3C) 

environment variable.getenv(3f) 

eqn and neqn.eqnchar(7) 

eqn constructs.derofT(l) 

eqn delimiters. .mmchek(l) 

eqn. neqn, checkeq: format mathematical text for . . eqn(l) 
eqnchar: special character definitions for eqn and . eqnchar(7) 
erand48, lrand46. nrand46. mrand48. irand48, . . . drand48(3C) 
erf. erfc: error function and complementary error . erf(3U) 
erfc: error function and complementary error .... erf(31l) 

errno: system error messages.perror(3C) 

error: analyze and disperse compiler error.error(l) 

error function and complementary error function. . erf(3U) 

error function.erf(3U) 

error log.dmesg(8) 

error message Ale by massaging C source.mkstr(1) 

error messages.. # error(l) 

error messages.perror(3C) 

error numbers.intro(2) 

error*handling function. .matherr(3ll) 

errors..spell(l) 

establish mount table.setmnt(B) 

/etc/groupmap: user and group id mappings for the pwmap(5N) 

/etc/mapL-port—eadr: table of ethernet addresses. . ethmap(SN) 

/etc/mkalias: create an alias to a remote Ale.mkalias(8N) 

/etc/mksys: make a remote system node.mksys(6N) 

/etc/NCsetup: initialise the Newcastle Connection . NCsetup(8N) 
/etc/pwmap, /etc/groupmap: user and group id . . pwmap(3N) 

/etc/rmsys: remove a remote system name.rmsys(8N) 

/etc/setugi: alter user id of a UNIX server.setugi(8N) 

/etc/startnc, /etc/stopnc: starts up (closes down) . startnc(8N) 

/etc/stopnc: starts up (closes down) the Ale.startnc(BN) 

/etc/usam initiate a UNIX server for a remote . . . usam(8K) 
/etc/utab: neighbours known to the Newcastle . . . utab(5N) 

etext, edata: last locations in program. .end(3C) 

ethernet addresses.ethmap(5N) 

ethname: get name/ethernet*identiAcation of .... uname(2) 

Euclidean distance function.hypot(3U) 

evaluate arguments as an expression.expr(l) 

evaluation command.test(l) 

ex: text editor.ex(l) 

ex. vi:.vi(l) 

excr : run a program on another system.excr(lN) 

execl, exeev, execle, exeeve, exeelp, exeevp:.exec(2) 

execle, exeeve, exeelp, exeevp: execute a Ale.exec(2) 

exeelp, exeevp: execute a Ale.exec(2) 

execute a Ale.exec(2) 

execute command.xargs(l) 

execute commands at a later time.at(l) 

execution.env(l) 

execution for an interval.sleep(l) 

execution for interval.. sleep(3C) 

execution profile.monitor(3C) 

execution time profile.proAl(2) 

execution.uux(lC) 

exeev, execle, exeeve, exeelp, exeevp: execute a . . . exec(2) 

.exeeve. exeelp, exeevp: execute a file.exec(2) 

exeevp: execute a file.exec(2) 

exercise link and unlink system calls. .link(8) 

existing one.creat(2) 

exit, -exit: terminate process. .exit(2) 

—exit: terminate process.exit(2) 

exp, dexp, cexp: Fortran exponential intrinsic .... exp(3f) 
exp. log. loglO. pow, sqrt: exponential, logarithm. . . exp(3U) 

expand tabs to spaces, and vice versa.expand(l) 

expand, unexpand: expand tabs to spaces, and vice . expand(l) 

expire: remove outdated news articles..expire(8) 

explain: print wordy sentences, interactive .diction(l) 

explicit Fortran type conversion, /idint. real.ftype(3f) 

Exploring The Dungeons of Doom. .rogue(8) 

exponent.frexp(3C) 

exponential intrinsic function.exp(3f) 

exponential, logarithm, power, square root .exp(3U) 

expr: evaluate arguments as an expression.expr(l) 

expression compile and match routines.regexp(7) 

expression compile.regcmp(l) 
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regex, regcmp: regular expresaion compile/execute.regexpX) 

expr. evaluate argument* as an expresaion. • • .. 

eft Extended Fortran Language.efl(l) 

greek; graphics for the extended TTY-37 type-box. •••••••• cretk{7) 

strings, xstr. extract strings from C programs to implement shared xstr(l) 

f77; Fortran 77 compiler.f77(l) 

functions, floor, ceil, fmod, fabs: floor, ceiling, remainder, absolute value .... floor(3U) 

factor, factor a number...factoKl) 

factor: factor a number.factor(l) 

true, false; provide truth values..true(l) 

checkall: faster file system checking procedure.checkal!(8) 

abort: generate an IOT fault. ..•te°rt.(3C) 

fclose. fflush: close or flush a stream. .. fclose(3S) 

fcntl: file control.fcntl(2) 

fcntl; file control options..fcntl(7) 

eevt. fevt: output conversion..ecvt(3C) 

fopen, freopen. fdopen: open a stream..fopen(3S) 

stctrl.stsldp; special streamer features, skip flies. 

col: filter reverse line feeds. 

ferror. feof, clearerr. flleno: stream status inquiries. .... ferror(3S) 

inquiries, ferror, feof, clearerr, flleno: stream status.ferror(3S) 

subroutines, dbminit, fetch, store, delete, ftrstkey. nextkey: data base . . . dbm(3X) 

system, ft: list file names and statistics for a file.ff(8) 

fclose, fflush: close or flush a stream. .fdose(3S) 

getc. getchar, fgetc. getw: get characUr or word from stream. . . . getc(3S) 

gets, fgets: get a string from a stream.gets(3S) 

grep. egrep, fgrep: search a file for a pattern. 

umask: set file-creation mode mask. . ..umask(l) 

basename: strip filename affixes.? ft,ex !?I5v ! ' 

ferror. feof. clearerr. flleno: stream status inquiries..* • rerrorl35J 

acct.com: aearch and print process accounting flle(i). • • • .. 

compact, uncompact, coat: compresa and uncompress H*™*'**^,,^ ! ! ! SESS) 0 

more, page: file perusal filter for ert viewing. 

nl: line numbering filter. . • • : • .. 

eolert: filter nroff output for CRT preriewmg.colcrt(l) 

col: Alter reverse line feeds.. 

plot: graphics Alters.. f 

tplot: graphics filters.... tplot(lC) 

refer, lookbib: find and insert literature references in documents. . refer(l) 

find: find flies. 

find: find flies.flnd(l) 

hyphen: find hyphenated words..hypnen(l) 

look: find lines in a sorted list..k>ok(l) 

ttyname. isatty: find name of a terminal. ..ttyname(3C) 

lorder. find ordering relation for an object library.lorder(l) 

spell, spellin. spellout: find spelling errors....■.* pell ^ 1 l,x 

binary, flic, strings: And the printable strings in a object, or other .... strings(l) 
ttyslot: find the slot in the utmp file of the current user. . . ttyslot(3C) 

finger, user information lookup program .flnger(l) 

fold: fold long lines for Anita width output device. . . . . •. f J ? ld( , 1 .U 

dbminit, fetch, store, delete. Arstkey. nextkey: date base subroutines.dbm(3X) 

tee: pipe fitting...^**11/ 

explicit Fortran type/ int. iflx, idint, real, float, sngl, dble. cnylx, dcmplx. ichar. char.. 

r fp: Floating Pomt on the CADMUS.«Pw) 

absolute value functions, floor, ceil. fmod. fabs: floor, ceiling, remainder. . . . fl°°r(3ll) 

functions, floor, ceil. fmod. fabs: floor, ceiling, remainder, absolute value. 

rxctrl: floppy disk manipulating program.rxc trill) 

ot. ox: TU 503/TU 803/TM 703 disk. TM 100-4 floppy disk.ot(4) 

rx : RX01 or RX02 floppy disk. 

fclose, fflush: close or flush a stream . ..; • • • ■. 

value functions, floor, ceil, fmod. fabs: floor, ceiling, remainder, absolute .... floor(3M) 

fmt: simple text formatter. 

device, fold: fold long lines for finite width output.fold(l) 

fold: fold long lines for finite width output device.fold(l) 

vfont: font formats for the Benson-Varian or Versa tec. . . . vfont(5) 

vfontinfo: inspect and print out information about fonts. . . . . ..• .. 

* fopen, freopen, fdopen: open a stream.fopen(35) 

fork: create a new process..fork(2) 

dmesg: collect system diagnostic messages to form error log.dm«»g(®) 

indent: indent and format a C program source.indentU) 

acct: per-process accounting file format. . .' 

ar: archive Oibrary) file format. .. 

format: how to format disks.forma UB) 

dump, ddate: incremental dump format. .7^2%% 

format: how to format disks. .forma t(B) 

eqn. neqn. checkeq: format mathematical text for nroff or troff. 

inode: format of an inode.inode(5) 

core: format of core image file.core(5) 
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cpio: 

dir 
a.out: 
a.out: 
sccsflle: 
fa: flic system 
fspec: 
tbl. 

trofT, nrofT: typeset or 
vfont: font 
intro: introduction to ftie 
utmp, vtmp: utmp and wtmp entry 
scanf. fscanf, sscanf: 
nun print out documents 
fmt: simple text 
printf. forint!, sprintf: output 
mptx: the macro package for 
check: disk checking and 
mm the UU macro package for 
mosd: the OSDD adapter macro package for 
man: macros for 
ms: macros for 
me: macros for 


f77: 

abs, iabs, dabs, cabs, zabs: 

signal: specify 
acoa, dacoa: 
a sin. dasin: 
atan2, datan2: 
atan, datan: 
and. or. xor, not. lshift. rshift: 

getarg: return 
log 10. aloglO. dloglO: 
conjg. dconjg: 
cos. dcos. ccoc 
ratfor. rational 
getenv: return 
exp, dexp,cexp: 
cosh, dcosh: 
sinh, dsdnh: 
tanh. dtanh: 
aimag, dimag: 

aint, dint: 
efl: Extended 

max, maxO, amaxO, maxi, amaxl, dmaxl: 
min, minO, aminO, mini, aminl, dminl: 

log. alog, dlog, clog: 
anint, dnint, nint, idnint: 
abort: terminate 
struct: structure 
mod, amod, dmod: 

sin, dsin, csin: 
sqrt, dsqrt, csqrt: 
len: return length of 
index: return location of 
system: issue a shell command from 
tan, dtan: 
mclock: return 
sign, isign. dsign: 
sngl, dble, cmplx, dcmplx, ichar, char: explicit 

rand, srand: 


printf, 
putc, putchar. 

puts, 
C stack 


df: report number of 
df: report number of 
malloc, 
fopen. 
hertz: get the line 
exponent, 
colrm: remove columns 
gets, fgets: get a string 
rmdel: remove a delta 
getopt: get option letter 
xstr: extract strings 
read:read 


format of cpio archive.cpio(S) 

format of directories..dir(5) 

format of programs and modules. .ahdr(5) 

format of programs and modules. .a.out(5) 

format of SCCS Ale.sccsflle(5) 

format of system volume.f*(5) 

format specification in text flies.fspec(5) 

format tables for nrofT or trofl.tbl(l) 

format text.trofl(l) 

formats for the Benson-Vahan or Versa tec.vfont(5) 

format*.intro(5) 

format*.utmp(S) 

formatted input conreraion.*canf(3S) 

formatted with the Uli macro*..mm(l) 

formatter.fmt(l) 

formatter*.printf(3S) 

formatting a permuted index.mptx(7) 

formatting.check(B) 

formatting documents..mm(7) 

formatting documents..mosd(7) 

formatting entries in this manual.man(7) 

formatting manuscripts. .ms(7) 

formatting papers. .me(7) 

Fortran 77 compiler.f77( 1) 

Fortran absolute value.abs(3f) 

Fortran action on receipt of a system signal .... signal(3f) 

Fortran arccosine intrinsic function..acos(3f) 

Fortran arcsine intrinsic function. . ..asin(3f) 

Fortran arctangent intrinsic function.atan2(3f) 

Fortran arctangent intrinsic function.atan(3f) 

Fortran bitwise boolean functions.bool(3f) 

Fortran command-line argument. . .'.getarg(3f) 

Fortran common logarithm intrinsic function.log 10(3f) 

Fortran complex conjugate intrinsic function.conjg(3f) 

Fortran cosine intrinsic function.cos(3f) 

Fortran dialect.ratfor(l) 

Fortran environment variable.getenv(3f) 

Fortran exponential intrinsic function.exp(3f) 

Fortran hyperbolic cosine intrinsic function. .... cosh(3f) 

Fortran hyperbolic sine intrinsic function.sinh(3f) 

Fortran hyperbolic tangent intrinsic function.tanh(3f) 

Fortran imaginary part of complex argument. .... aimag(3f) 

Fortran integer part intrinsic function. .aint(3f) 

Fortran Language.efl(l) 

Fortran maximum-value functions.max(3f) 

Fortran minimum-value functions.min(3f) 

Fortran natural logarithm intrinsic function.log(3f) 

Fortran nearest integer functions..round(30 

Fortran program..abort(3f) 

Fortran programs.struct(I) 

Fortran remaindering intrinsic functions..mod(3f) 

Fortran sine intrinsic function...sin(3f) 

Fortran square root intrinsic function..sqrt(3f) 

Fortran string.len(3f) 

Fortran substring.index(30 

Fortran...system(30 

Fortran tangent intrinsic function.tan(3f) 

Fortran time accounting.mc!ock(3f) 

Fortran transfer-of-sign intrinsic function.sign(3f) 

Fortran type conversion, /iflx, idint, real, float, . . . ftype(3f) 

Fortran uniform random-number generator.rand(3f) 

fp: Floating Point on the CADUUS.fp(3) 

fprintf, sprintf: output formatters.printf(3S) 

fputc, putw: put character or word on a stream. . . . putc(3S) 

fputs: put a string on a stream..puts(3S) 

frame layout.stack(5) 

freed, fwrite: buffered binary input/output..fread(3S) 

free disk blocks.df(l) 

free disk blocks.df(8) 

free, realloc, calloc: main memory allocator.malloc(3C) 

freopen, fdopen: open a stream. .fopen(3S) 

frequency on the current machine.hertz(2) 

frexp, ldexp, modf: split into mantissa and.frexp(3C) 

from a Ale.colrm(l) 

from a stream. .gets(3S) 

from an SCCS file.rmdel(l) 

from argv.getopt(3C) 

from C programs to implement shared strings.xstrfl) 

from Ale.read(2) 
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it item: issue a shell command from Fortran.JJ"*. 1 ? ( 3f) 

from: who is my mail from?. .. 

ncheck: generate names from i-numbers."flArt 

nlist: get entries from name list.• • • 

soelim: eliminate .so's from nroff input. • • ■ .. 

acctcms: command summary from per-process accounUng records. .acctcmsW 

getc. getchar. fgetc. getw: get character or word from stream. .Kwaci 

“ getpw: get name fromUID. ••••••• . i v ,,\ 1 

from: who is my mail from?.from(l) 

fr. flic system format of system volume.fs(5) 

fsba: file system block analyser.fsba(0) 

scanf. fscanf, sscanf: formatted input conversion.scanf(3S) 

checklist, list of file systems processed by fsck. . . . .. ••••••:••. . 

interactive repair, fscke dfsck: file system consistency check and .... 

fsdb: file system debugger. b v®) 

fseek, ftell, rewind: reposition a stream..fseektas; 

fspec: format specification in text flies.fspec(5) 

stau fstat: get file status..“'RL. 

fseek. full, rewind: reposition a stream. ., ' 

ftw: walk a file tree. 

chfn: change full name of user..• • . 

erf erfc: error function and complementary error function.erf^Mj 

structure, fuser: identify procesees using a file or fLe.fuser(S) 

fread. fwrite. buffered binary input/output.freadl») 

records, fwtmp. wtmpflx: manipulate connect accounting . . . fwtmplB) 

backgammon: the him. . v . v .. 

startrek: THE game based on the t.v. senes..startrekU) 

moo: guessing game. • . .. 

back: the game of backgammon. . 

bi: the game of black jack. 

craps: the game of craps.crapsW 

reversi: reversi. a game of drama tic reversals. . re**™'W 

vump: the game of hunt-the-wumpus..wumpU) 

intro: introduction to games. . . .. u . 

gamma, log gamma function.. gamma(31j) 

gamma: log gamma function. 

send: gather files and submit RJE jobs.. 

abort: generate an 10T fault... • • obort(3C) 

newconf: generate conflguration file and reconfigure lluhX . newcon*ie) 

makekey: generate encryption key. rMkCk !Tic\ 

ctermid: generate file name for Urminal. 

ncheck: generate names from i-numbers. ..j C 

/mrand48, jrand48, srand48. seed48. lcong48: generate uniformly ) di»lributedl p»eudo-r«adom/ . . £end48(3C) 

J lex: generator of lexical analysis programs. . 

rand, srand: random number generator. 3 S,/ 

rand, arand: Fortran uniform random-number generator. • • • • ......f3Sl 

r ' gets, fgetx get a string from a stream.. 

get: get a version of an SCCS file. 

ulimit: get and set user limit*.. ."“Act 

getc. getchar. fgetc. getw: get character or word from stream. .“ 

* nlist: get entries from name list..wi* 

umask: set and get file creation mask. 

stat. fstat: get file status. ..*‘.\ Z f L 

ustat: get Ale system statistics. 

gel: get a version of an SCCS file.g«Ul/ 

KtffSzrr .::::::::::::::::::WESW 

logname: get login name. .. 

getpw. get name from UID.. • • • • f^P^C) 

system, uname. ethname: get name/ethernet-identifleation of current UNIX . . un^e( 2 ) 

——-"SW R5SSS?S^:::::::::::::: a, 

...p.ml, ..ip-uid, “JSni 

times: get process and child process times. ••••••••• 

getpid. getpgrp. getppid: get process, process group, and parent process IDs. . getpid(2) 

:::::pST 

hertz: get the line frequency on the current machine. . . . hertz(2; 

getarg: return Fortran command-line argument. . . getarg(3f) 

from stream, getc. getchar. fgetc. getw: get character or word . . getc 3S 

\i S5S®1 

getenv. value for environment name.® ct ’ en T/r5'' 

ssxwssswssffjea v^gstssasrssssr. ::: ssb 
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t*tf rent. ..tgrgid, J-QW -jjgjjjfc-t P> «~>«. «S. . .‘..jr.^g ! 

getopt: get option letter from *rgr.! iVoftfan 

getopi: perse commend options.. *e*oStf 

. . l cl P‘« reed e password. 5etBM«Jni*t 

parent process IDs. getpid, getpgrp. jetppi<T get process, process group, end f., ££?/ 

group, end parent process IDs. getpid, getpgrp. getppid: get process, process <etDid(2) 

process IDs getpid. getpgrp. getppid: get process, profess,roupTwd pfSnt ! § 

. ... «etpw: get name from UtD.. .. ietnwfact 

ent £ * et P went - getpwnam. setpwent. endpwent: ' 5etp«nt(3C> 

entry, getpwent, getpwuid. g etpwnam, setpwent. endpwent: get password Ale setnwenr rnri 
password Ale entry, getpwent, getpwuid, getpwn.m, set?went, endp.entgVt . ! ! KS^Iaci 

.. ... geta fgets: get e string from a stream..fets(3S) 1 ' 

.. i m , , . discipline, jettj . set terminal type, modes, speed, and line 

gettydefs: speed and terminal settings used by getty.™ 

. _ 6 eU 7- gettydefs: speed and terminal settings used by aettvdefsrffl 

, . ' real < rou P' and eltectire group/ getuid. geteuid, getgid, getegid: get real user 1 ' Jetu?df2» ' 

*"1“**"^ Utrr -P nam e: access utmp Ale entry, getutent. getutid. getutline. put'tline. setutent, . ' ' |*tut(3C) 

utn^name: access utmp Ale entry, getutent, getutid. getutline. pututline. setutent. endutent. . fe’utI3cl 

access utmp Ale entry, getutent. getutid. getutline. pututline, setutent. endutent. utmpname. getut(3C) 
aer l lf tC, .? etC ^* r, , f ‘ etC> * etw character or word from stream. ...... ietc(3S) 

ASCII, ctime, localtirr.e, gmtime. asetime, tzset; consert date and time to . . ctime(3C) 
setjmp. longjmp: non-local goto. 

graph: draw, graph. .! ! ! ! ! ! JgS §> 

graph: draw a graph.. 

sag: system activity graph.. !!!**' Swig! 0 * 

plot: graphics Alters. ! plotVlG) 

tplot: graphics Alters.tpiot(lG) 

greek; graphics for the extended TTY-37 type-box.aree k(7\ 

plot: graphics interface. plot(5) * 

plot: graphics interface subroutines.. olotttlO 

mmt, mrt: typeset documents, view graphs, and slides. mrrtrn 

mv: a macro package for making view graphs. . !!!!.!!!. mv(7) 

greek: graphics for the extended TTY-37 type-box. * ! greekW 

. 5 j . * i - , grep, egrep. fgrep: search a Ale for a pattern.arep(l) 

getegid: get real user, effective user, real group, and effective group IDs. /geteuid, setrid. setuidm 

getpid. getpgrp, getppid: get process, process group, and parent process IDs. ' Sato df21 

chown, chgrp: change owner or group. * \ j 

getgrgid. getgrnam. setgrent. endgrent: get group Ale entry, getgrent. ...!.'!!!!!!*'* .-t,re-iVraet 

poup: group Ale. . ! ! JS) > 

group; group Ale. srouofS) 

/etc/pwmap. /etc/groupmap: user and group id mapping, for the Newcastle Connection. .' pwmaoISNI 

retpgrp: act procesa group ID.setpgfptt) 

_ id: print user and group IDs and names. idfl f ^ 1 

user, effective user, real group, and effective group rDs. /geteuid. getgid. getegid: get reai . .* f euidf2) 

setuid. setgid: set user and group IDs. setuidfll 

newgrp: log in to a new group.newgrp(l) 

chown; change owner and group of a Ale. chowntel 

kill: send a signal to a process or a group of processes. * ioUf 2 ) V 1 

make: maintain, update, and regenerate groups of programs.. ...!!.!!!!!!! make(l) 

pwck, grpek: password/group Ale checkers. .pwckffl) 

ssignal, gsignal: software signals.ssignal(3C) 

hangman: guess the word.hengman(d) 

moo: guessing game.moo(6) 

terminals, hp: handle special functions of HP 2640 and 2621-series hp(l) 

. , , hangman: guess the word. .hanamanf6) 

hsearch, hcreate. hdestroy: manage hash search tables.hsearch(3C) 

hsearch, hcreate. hdestroy: manage hash search tables . * ! hsearch(3C) 

nsearch. hcreate. hdestroy: manage hash search tables. hsearch(3C) 

V, U. help: ask for help.help(l) 

help: ask for help.help(l) 

machine, hertx: get the line frequency on the current.hertsf2l 

xd : hexadecimal dump.xd(l) * 

hier. Ale system hierarchy.. . hieVm 

hier: Ale system hierarchy.* hier(7) 

hk; RK611 /RK06. RK07 moving-head disk.hk(4) 

rl, hi: RL01 /RL02 moving-head disk. rlf4) 

hp: handle specif functions of HP 2640 and 2621-series terminals. .* hp(l ) 

2621-series Urminala hp: handle special functions of HP 2640 and . . . hp(l) 

hp: RP04/05/06, RM02/03 moving-head disk. .... hp(4) 
tables . hsearch, hcreate. hdestroy: manage hash search . . hsearchf3Cl 

wump: the game of hunt-the-wumpus.wump(6) 

cosh, dcosh: Fortran hyperbolic cosine intrinsic function.. cosh(3f) 

sinh. cosh, tanh: hyperbolic functions..sinh(3U) 

sinh. dxinh: Fortran hjrperbolic sine intrinsic function. .sinh(3f) 

tanh, dtanh: Fortran hyperbolic tangent intrinsic function.tan_h(3f) 

hyphen: And hyphenated words. .hyphen(l) 
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hyphen: And hyphenated words. ..kJEofAul 

7y hypot: Euclidean distance function. . . .. 

abs, iabs. dabs, cabs, xabs: Fortran absolute value.. * ,\L 

iarge: Number of command-line arguments. i&rtc&f) 

“SISs :::: 

/etc/setugi: alter user id of a UNIX server. ••:•••• • v 

id: print user and group IDs and names. .idll) 

seipgrp: set process group ID. : ^. Z2SZ) 

issue: issue identiflcation Ale.... 

fuser: identify processes using a Ale or Ale structure. . . . fuser(8) 

what; identify SCCS Ales. ... .... • • • .. 

ichar char exploit Fortran type/ int. iflx. idint. real, float. sngl. dble. cmplx. dcmpls.ftype(3f) 

ichar. char, expl.cit orlr V n ' p dniatt ,dnint: Fortran nearest integer functions.. 

id: print user and group IDs and names. ..L*tiii<|f21 

nKSKJI^S»SS8SSS«S; ::::: £31! 

core; format of core image file. .. ..fflt.ran 

a;mag. dimag: Fortran imaginary part of complex argument.“"“it 

x ,t r extract strings from C programs to implement shared strings. . . . • .. - t j 

which: locate a program file including aliases and path, (esh only).*hmh(l 

dump, ddate: incremental dump format.aumjHj>} 

dump: incremental file system dump.dumped) 

restor. incremental file system restore. re* orW 

indent; indent and format a C program source.P“ en h|) 

indent; indent and format a C program source. . . . indentU) 
tgetnum. tgetflag. tgetstr. tgoto, tputs: terminal independent operation routines, tgetent. ••• • •• *™ c $< 3 > 

mptx: the macro package for formatting a permuted index. .ptx(l) 

ptx. permute location of Fortran substring.index(3p 

inews: submit news articles.. 

inittab: script for the ini t process..• • • .• • ... * ; 

init, telinit: process control initialization.}J“ l W rou\ 

process. /etc/NCsetup: initialise the Newcastle Connection tables in a .... NCsetup(8N) 

init, telinit: process control initialization. • • • • •.^ 

bre bcheckrc rc, powerfail: system initialization shell scripts. .. v / 

ore. bcnecicrc. .c, po initiale 0 UNIX server for a remote client. usam <®*Q, 

popen. pclose; initiate I/O to/from a process..pop«nl3SJ 

* inittab: script for the init process..uuttab(5) 

dri; clear i*node.. 

inode: format of an inode.“ j rti 

inode: format of an inode. • • • ..UltnMasi 

seanf. fscanf. sscanf: formatted input conversion. 

ungetc: push character back into input stream.. 

fread. fwrite: buffered binary input/output. . .. ”*•*&*> 

stdio: standard buffered input/output package.Swast 

terror, feof. clearerr. flleno: stream status inquiries. .••••• .uuwtatflCl 

uustat: uucp status inquiry and job control. .. wtsto^lC) 

refer, lookbib: And and insert literature references in documents. ..re.erU) 

vfontinfo: inspect and print out information about fonts. . . . vfontuifo(l) 

install: install commands. ..?“”5®{ 

install: install commands.lnstallfBJ 

uucp: uucp installation made easy. UU< ?f i m 

—“ —>—:::::::::::::::: Sjfg 

PcmpU. icW. ch.r. eipLeil Forxr»nT* T**. ! i ! 1 1 1 SSfl’ 

anint. dnint, nint, idnint: Fortran nearest integer functions. • • • • .. 

aint. dint: Fortran integer part intrinsic function.. 

13 tol. ltol3: convert between 3-byte integers and long integers..5:° 

ltolfl: convert between 3-byte integer, and long copy / ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! ! bcopy(8) 

>sck dfsck: file system consistency check and interactive repair. • .. 

' nest.t: RJE status report and interactive status console ..2KE«ViV 

diction, explain: print wordy sentences, interactive thewurus for dicUon. .bb D 4 " ^ 

bbp: Basic Block Port Interface.. 

Id: KL-11 or DL-11 asynchronous interface.. 

lbp: LBP -10 Laser Beam Printer Interface..51 

plot: graphics interface. . > J 

sbp: Simplified Basic Block Port Interface.* J 

st: SCT11 Streamer interface. .. 

plot: graphics interface subroutines. 

termio: general terminal interface.Jr/Ji 1 ' 

tm,ts: TU-ll/TU-10 magtape interface. TS-11 magtape interface. 
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nfcomment: a user interface to the notesfile system..nfcomment(3) 

tmts: Til-11 /TU-10 magtape interface. TS-11 magtape interface.tm(4) 

tty: controlling terminal interface.tty(4) 

spline: interpolate smooth curve.spline(lG) 

basic: Basic Interpreter.basic(l) 

pti: phototypesetter interpreter.pti(l) 

sno: SN030L interpreter..sno(l) 

ifprolog: The prolog interpreter system..ifprolog(l) 

csh: a shell (command interpreter) with C-like syntax.csh(l) 

pipe: create an interprocess channel.pipe(2) 

configuration information: table of interrupt vector and device addresses..conftnfo(4) 

sleep: suspend execution for an interval.sleep(l) 

sleep: suspend execution for interval.aleep(3C) 

intro: introduction to commands.intro(l) 

intro: introduction to file formats..intro(5) 

intro: introduction to games.intro(6) 

intro: introduction to miscellany.intro(7) 

intro: introduction to special files.intro(4) 

intro: introduction to subroutines and libraries. . . . intro(3) 
numbers, intro: introduction to system calls and error .... intro(2) 

procedures, intro: introduction to system maintenance .intro(8) 

ncheck: generate names from i-numbers..ncheck(fl) 

popen. pclose: initiate I/O to/from a process. .popen(3S) 

iocU: control device.ioctl(2) 

abort: generate an I0T fault. .abort(3C) 

isalpha, isupper, ialower, iedigit, indixit, isalnum, isspace, ispunct, isprint, isgraph./ .ctypef3C) 

isalnum isspace. ispunct, isprint, isgraph./ isalpha. isupper. islewer. isdigit. isxdigit.ctype(3C) 

isspace. ispunct. isprint. isgraph. iscntrl, iaascii: classify characters, /isxdigit. isalnum. .... ctype(3C) 

ttyname. isatty: find name of a terminal...ttyname(3C) 

isalnum. isspace. ispunct. isprint. isgraph, iscntrl, isascii: classify characters, /isxdigit, .... ctype(3C) 

isprint, isgraph./ isalpha. isupper. ialower. isdigit. isxdigit. isalnum, isspace, ispunct.ctype(3C) 

/isxdigit, isalnum isspace. ispunct. isprint. isgraph. iscntrl. isascii: classify characters.ctype(3C) 

function, sign, isign. dsign: Fortran transfer-of-sign intrinsic .... ®gn(3() 

ispunct. isprint, isgraph,/ isalpha. isupper. islower, isdigit, isxdigit, isalnum. isspace.ctype(3C) 

/isdigit. isxdigit. isalnum isspace. ispunct. isprint. isgraph. iscntrl. isascii: classify/.ctype(3C) 

/islower, isdigit. isxdigit. isalnum isspace. ispunct. isprint. isgraph. iscntrl. isascii:/ .ctype(3C) 

/isupper, islower. isdigit, isxdigit. isalnum isspace. ispunct. isprint. isgraph. iscntrl./.ctype(3C) 

system issue a shell command.system(3S) 

system issue a shell command from Fortran.system(3f) 

issue: issue identification file.issue(5) 

issue: issue identification file.issue(S) 

isspace. ispunct. isprint. isgraph./ isalpha, isupper. islower. isdigit, isxdigit, isalnum .ctype(3C) 

isgraph./ isalpha. isupper. islower. isdigit. isxdigit, isalnum isspace. ispunct, isprint.ctype(3C) 

news: print news items. .news(l) 

j0. jl. jn. yO. yl. yn: Bessel functions.bessel(3U) 

jO. jl, jn. yO, yl, yn: Bessel functions. .bessel(3U) 

bj: the game of black jack..bj(8) 

jO. jl, jn, yO, yl. yn: Bessel functions..bessel(3U) 

join: relational database operator.join(l) 

drand48. erand48. Irand48, nrand48, mrand48. jrand48. srand48, seed48, lcong48: generate/ .... drand48(3C) 

msgs: system messages and junk mail program .msgs(l) 

whatconf: what device drivers are in an unix kemeL.whatconf(8) 

makekey: generate encryption key.makekey(8) 

keycap: keyboard capability data base.keycap(5) 

keycap: keyboard capability data base.keycap(5) 

apropos: locate commands by keyword lookup.apropos(l) 

killall: kill all active processes..kiliall(8) 

processes, kill: send a signal to a process or a group of.kill(2) 

kill: terminate a process..kill(l) 

killall: kill all active processes.ldllall(8) 

kl: KL-11 or DL-11 asynchronous interface.kl(4) 

kl: KL-11 or DL-11 asynchronous interface.kl(4) 

mem kmem core memory.mem(4) 

quix: test your knowledge.quiz(6) 

Is. 11. 1. lr. If. lx: list contents of directory.ls(l) 

long integers. 13tol, ltol3: convert between 3-byte integers and . . . l3tol(3C) 

a84l, 184a: convert between long and base-84 ASCII.a64l(3C) 

volcopy, labelit: copy file systems with label checking.volcopy(8) 

volcopy, labelit: copy file systems with label checking.volcopy(8) 

awk: pattern scanning and processing language.* wlc 0) 

be: arbitrary-precision arithmetic language.hc(l) 

eft: Extended Fortran Language.«fi(l) 

epp: the C language preprocessor.cpp(l) 

shell, the standard/restricted command programming language, sh. rsh:.*b(}) 

lbp: LB P-10 Laser Beam Printer Interface.lbp(4) 

prtacct. runacct,/ chargefee, ckpacct. dodisk. lastlogin, monacct, nulladm pretmp. prdaily.acctsh(8) 

C stack frame layout.stack(5) 

lbp: LBP-10 Laser Beam Printer Interface.lbp(4) 

ItrofT. vtrofl: troff to the CANOK LBP or the Versatec V80.ltroff(l) 
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lbp: 

cc. 

nrand48. mrand48, jrand48, srand48. seed48. 

frexp, 

leave: remind you when you have to 


len: return 
getopt: get option 

lex: generator of 
Is. 11 Ur. 

intro: introduction to subroutines and 
ranlib: convert archives to random 
ar: archive 

lorder. And ordering relation for an object 
ar: archive and 
ulimit: get and set user 
getty : set terminal type, modes, speed, and 
col: filter reverse 
hertx: get the 
line: read one 
nl: 

cut: cut out selected fields of each 

lp : parallel 
1 pctrl: set options on the parallel 

lpr. 

1 search: 
head: give first few 
link, unlink: exercise 

cp, In, mv: copy. 

link: 

calls. 


Is. 11.1. lr. If. lx: 

ff: 

look: find lines in a sorted 
nlist: get entries from name 
nm: print name 
checklist: 
users: compact 
cref: make cross-reference 
xref : cross-reference 
xargr. construct argument 
refer, lookbib: find and insert 
la. 


time to ASCII, ctime. 
(esh only), which: 

apropos: 
whereis: 
index: return 
end, etext, edata: last 
plock: 

intrinsic function, 
collect system diagnostic messages to form error 

gamma: 

newgrp: 

power, square root functions, exp. 

intrinsic function, 
square root functions, exp. log. 
log 10. aloglO. dloglO: Fortran common 
log. alog, dlog. clog: Fortran natural 
exp. log. log 10. pow, sqrt: exponential, 
getlogim get 
logname: get 
cuserid: character 
logname: 
passwd: change 

profile, setting up an environment at 


LBP-10 Laser Beam Printer Interface.lbp(4) 

lcc: C compiler.cc(l) 

lcong48: generate uniformly distributed/ /lrand48. . drand48(3C) 

Id: loader.ld(l) 

ldexp. modf: split into mantissa and exponent. . . . frexp(3C) 
learn: computer aided instruction about UNIX . . . leam(l) 

leave.leave(l) 

leave: remind you when you have to leave.leave(l) 

len: return length of Fortran string.len(3f) 

length of Fortran string.len(3f) 

letter from argv.getopt(3C) 

lex: generator of lexical analysis programs.lex(l) 

lexical analysis programs.lex(l) 

If. lx: list contents of directory.ls(l) 

libraries.intro(3) 

libraries.ranlib(l) 

(library) file format..*r(5) 

library.lorder(l) 

library maintainer.ar(l) 

limits.ulimit(2) 

line discipline.g«tty(8) 

linefeeds.col(l) 

line frequency on the current machine.hertz(2) 

line.line(l) 

line numbering filter.ol(l) 

line of a file.cut(l) 

line printer daemon. .lpd(8) 

line printer.W 4 ) * 

line printer.lpctrl(l) 

line printer spooler.lpKO 

line: read one line.line(l) 

linear search and update.lsearch(3C) 

lines.head(l) 

link and unlink system calls. .link(8) 

link: link to a file.link(2) 

link or move files..cp(l) 

link to a file.link(2) 

link, unlink: exercise link and unlink system.link(8) 

lint: a C program verifier.lint(l) 

list contents of directory.1*0) 

list file names and statistics for a file system. .... fT(8) 

list. .. look(l) 

list. .niist(3C) 

list. .nm(I) 

list of file systems processed by fsck.checklist(5) 

list of users who are on the system. .users(l) 

listing.cref(l) 

listing.xref(l) 

list(s) and execute command.xargs(l) 

literature references in documents.refer(l) 

11.1. lr. If, lx: list contents of directory.ls(l) 

In. mv: copy, link or move files..cp(l) 

loader.ld(l) 

localtime, gmtime, asetime. txset: convert date and . ctime(3C) 
locate a program file including aliases and paths . . which(l) 

locate commands by keyword lookup.apropos(l) 

locate source, binary, and or manual for program. . whereis(l) 

location of Fortran substring.index(3f) 

locations in program..end(3C) 

lock process, text, or data in memory.plock(2) 

lock: reserve a terminal.lock(l) 

log. alog. dlog. clog: Fortran natural logarithm . . . log(3f) 

log. dmesg: .dmesg(B) 

log gamma function. .gamma(3U) 

log in to a new group.newgrp(l) 

log. loglO, pow, sqrt: exponential, logarithm,.exp(3M) 

log 10. alog 10, dloglO: Fortran common logarithm . . 1ogl0(3f) 
log 10 . pow, sqrt: exponential, logarithm, power. . . . exp(3U) 

logarithm intrinsic function. .Iogl0(3f) 

logarithm intrinsic function. . • log(3f) 

logarithm, power, square root functions.exp(314) 

login name.getlog:n(3C) 

login name.logname(l) 

login name of the user.•.cusend(3S) 

login name of user.logname(3X) 

login password.pesswd(l) 

login: sign on..login(l) 

login time.proftle(5) 

logname: get login name.logname(l) 
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setjmp. 
documents, refer, 
apropos: locate corrmandj by keyword 
finger: user information 
library. 

nice, nohup: run a command at 


Is. U. 1. 

seed48. Icong4Q. generate/ drand48, erand48, 


and, or. zor, not, 
integers. 13tol, 
Versatec V80. 
Is. 11.1. lr. If. 

hertz: get the line frequency on the current 

mptz: the 
mm the kill 
mosd: the OSDO adapter 
mr. a 
m4: 

mm print out documents formatted with the UII 

mt: 

tm.ts: TU-11 /TU-10 magtape interface. TS-11 
tm,ts: Tll-1 l/TU-10 
from: who is my 
prmail print out 
mail, rmail: send mail to users or read 
msgs: system messages and junk 
recnews: receive unprocessed articles via 
recnews; receive unprocessed articles via 

sendnews: send news articles via 
mail, rmail: send 
uurec: receive processed news articles via 
uucp.. mail.nc: 
instead of uucp.. 
malloc, free, realloc, calloc: 

programs, make: 
ar: archive and library 
intro: introduction to system 
delta: 
mkdir: 
mknod: 
/etc/mksys: 
mktemp: 

cref: 

banner. 

programs. 

script: 

allocator. 


tsearch, tdelete. twalk: 
hsearch, hcreate, hdestroy; 

fwtmp, wtmpflz: 
mt: magnetic tape 
rzctrl: floppy disk 
man, 

frezp, Idezp. modf: split into 
catman: create the cat flies for the 
whereis: locate source, binary, and or 
man, manprog: print entries in this 
man: print sections of this 
man: macros for formatting entries in this 
ms: macros for formatting 
ascii: 

/etc/pwmap, /etc/groupmap: user and group id 
umask: set Ale-creation mode 
umaak: set and get file creation 
mkstr: create an error message file by 


logname: login name of user.logname(3X) 

ongjmp: non-local goto. .aetjmp(3C) 

looicbib: find and insert literature references in . . . refer(l) 

lookup.apropoa(l) 

ookup program. .ftnger(l) 

lorder: And ordering relation for an object.lorder(l) 

low priority . . .nice(l) 

lp : parallel line printer.i p ( 4 ) 

Ipctrl: set options on the parallel line printer.Ipctrl(l) 

lpd: line printer daemon.lpd(8) 

lpr. line printer spooler.lpr(l) 

lr, If, lz: list contents of directory.i*(i) 

lrand48, nrand48. mrand48, jrand48. srand48.drand48(3C) 

l s, 11,1, lr. If, lz: list contents of directory.l»(i) 

.search: linear search and update.lsearch(3C) 

lseek: move read/write file pointer.lseek(2) 

1 shift, rshift: Fortran bitwise boolean functions. . . . bool(3f) 
ltol3: convert between 3-byte integers and long . . . 13tol(3C) 

1 troll, vtrofT: troll to the CANON LBP or the.ltroff(l) 

lz: list contents of directory.i*(i) 

m4: macro processor.m4(l) 

machine.hertz(2) 

macro package for formatting a permuted indez. . . mptz(7) 

macro package for formatting documents.mm(7) 

macro package for formatting documents.mosd(7) 

macro package for making view graphs. .mv(7) 

macro processor.m4(1) 

macros. .mm(l) 

magnetic tape manipulating program..mt(l) 

magtape interface.tm(4) 

magtape interface. TS-11 magtape interface.tm(4) 

mail from?.from(l) 

mail in the post office.prmail(l) 

mail..mail(l) 

mail program..msgs(l) 

mail.recnews(l) 

mail.recnews(8) 

mail, rmail: send mail to users or read mail.mail(l) 

mail.eendnews(8) 

mail to users or read mail.mail(l) 

mail.uurec(8) 

mail(l) using the Newcastle Connection instead of . . mail(lN) 
mail.nc: mail(l) using the Newcastle Connection . . . mail(lN) 

main memory allocator.maDoc(3C) 

maintain, update, ond # regenerate groups of.make(l) 

maintainer...ar(l) 

maintenance procedures.intro(8) 

make a delta (change) to an SCCS file.delta(l)- 

make a directory.mkdir(l) 

make a directory, or a special or ordinary file.mknod(2) 

make a remote system node.mksys(8N) 

make a unique file name.mktemp(3C) 

make cross-reference listing.cref(l) 

make long posters.banner(6) 

make: maintain, update, and regenerate groups of . make(l) 

make typescript of terminal session..script(l) 

makekey: generate encryption key.makekey(8) 

malloc. free, re alloc, calloc: main memory.malloc(3C) 

man: macros for formatting entries in this manual. . man(7) 

man, manprog: print entries in this manual.man(l) 

man: print sections of this manual.man(lb) 

manage binary search trees. .tsearch(3C) 

manage hash search tables.hsearch(3C) 

manipulate connect accounting records.fwtmp(8) 

manipulating program..mt(l) 

manipulating program..rzctrl(l) 

manprog: print entries in this manuaL.man(l) 

mantissa and exponent..frexp(3C) 

manual.catman(8) 

manual for program. .whereis(l) 

manual.man(l) 

manual.man(lb) 

manual.man(7) 

manuscripts. .ms(7) 

map of ASCII character set.ascii(7) 

mappings for the Newcastle Connection.pwmap(SN) 

mask.umask(l) 

mask.u mask (2) 

massaging C source.mkstr(l) 
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regexp: regular expression compile end match routine*. .. 

eqn. neqn. checkeq: format mathematical text for nrofl or trofl.™therrf3Ul 

^ math err: error-handling function.matherr(3ll) 

maximum-value function*, max. maxO. amaxO. maxJ. ama^. dmaxl: fortran . max(3f) 
maximum-value function!, max. maxO. amaxO. maxi, amaxl. dmaxl. Fortran .... max(3f) 
funcUons. max. maxO. amaxO. maxi, amaxl. dmaxl: Fortran maximum-value . . . max (30 

max. maxO. amaxO, maxi, axaxl. dmaxl: Fortran -^-^VoTr^Sn. .ccounti^ ‘ ! ! ! ! ! ! “Sf) 

med: screen editor.wfJfgV 

bed. ppt: convert to antique media.W 

y mem, kmem core memory.mem(4) 

malloc. free, realloc, celloc: main memory allocator. 

mem. kmem: core memory. 

plock: lock process, text, or data in memory..jilTflV 

sort: sort or merge flies. . . ..• • .. 9ony) 

acctmerg: merge or add total accounting flies.acctmerglBJ 

lines of one file, paste: merge same lines of several flies or subsequent . . . paste(lX- 

mesg : permit or deny messages..m?: 

mkstr: create an error message file by massaging C source. . ..mksirtl) 

minimum-value functions, min. minO. aminO. mini, aminl. dnunl: Fortran . . . «»ni3f) 

minimum-value functions, min. minO. aminO. mini, aminl. 4mini: Fortran.nun 3f) 

function*, min, minO. aminO. mini, aminl. dnunl: Fortran minimum-value .... min(3f) 
min. minO. aminO. mini, aminl. dminl: Fort«m funcU0 “; . ! | | | ! ^68(1) 

mkdir : make a directory. 

mkfs: construct a file system.. inkf *W 

::: SSSi 

file, mknod: make a directory, or a special or ordinary . . mknod(2) 

source, mkstr: create an error message file by massaging C . mkstr(l) 

mktemp: make a unique file name.mktempi3C) 

mm: the UU macro package for formatting documents.mm(7) 

mmchek: check usage of mm macros and eqn delimiters.mmchek(l) 

mm: print out documents formatted with the UU macros. ..... ... . 

^ macros, mm: prmt out documents formatted with the Ull . . mmtl) 

mm: the UU macro package for formatting documents. mm(7) 
delimiters, mmchek: check usage of mm macros and eqn . . . . mmchek(l) 

slides, mmt, mvt: typeset documents, view graphs, and . . . mmt(l) 

mnttab: mounted file system table.mnttab(5) 

functions, mod. a mod. dmod: Fortran remaindering intrinsic . . mod(3f) 

chmod: change mode.chmod(l) 

umask: set file-creation mode mask. 

chmod: change mode of file. •••••••••. .* 

getty : set terminal type, modes, speed, and line discipline.5 m t 

bs: a compiler/interpreter for modest-sixed program*. •••••••; .SL.iffiCi 

frexp. ldexp. modf: split into mantissa and exponent.frexp(3C) 

utime: set file access and modification times.' 

long: system calls modified for long arguments.. 

long: standard procedures modified for long arguments..i ong uM\ 

touch: update date last modified of a file. 

a.out: format of programs and modules.*™A S \ 

a out: format of programs and modules.. ... t / 

runacct./ chargefee. ckpacct. dodisk. lastlogin. monacct. nulladm, pretmp. prd**Tj Placet. 

™ ' • monitor: prepare execution profile.monitor^; 

uusub: monitor uucp network.uusub(8) 

moo: guessing game.moo^ 

more, page: file perusal filter for ert viewing.more(l) 

documents, mosd: the OSDD adapter macro package for formatting mosd(7) 

curses: screen functions with "optimal” cursor motion. .^“^21 

mount: mount a file system.. 

mount, umount: mount and dismount file system.. 11,0 

mount: mount a file system .mountlZ) 

setmnt: establish mount table. ••*•••• * * * * * * * 

mount, umount: mount and dismount file system . . mountlB) 

mnttab: mounted file system table.mnttab(5) 

mvdir. move a directory.mvdir(B) 

cp. In. mv. copy, link or move flies. •••••••• .Siuiai 

lseek: move re ad/write file pointer.uufT* 

hk: RK611/RK08. RK07 moving-head disk. 

hp: RP04/05/06, RM02/03 moving-head disk. . 

rl. hi: RL01 /RL02 moving-head disk. 

rm RU02/03/05 movinrhead disk.. • .; • * rm 4 ',. 

index, mptx: the macro package for formatting a permuted mptx(7) 

generate/ drand4B. erand48. Irand48. nrand4B. mrand 48 . jrandjB. srand48. seed4B. lcong48: .... ^and48(3C) 

® cn ms. macros for formatting manuscripts.ms(7) 

msgs: system messages and junk mail program . . . msgs(l) 

mt: magnetic tape manipulating program. 

dx.dh:DZ-ll.DH-11 asynchronous multiplexers. .. 

generate configuration file and reconfigure 1IUNDC newconf: ... • • newconf(8) 
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mv: a macro package for making view graph*. .... irv(7) 

cp. In, mv: copy, link or move flies..cp(l) 

mvdir. move a directory.mvdir(6) 

mmt, mvt: typeset documents, view graphs, and slides. . . mmt(l) 

pipe: Pipes and named pipes. .pipe(4) 

system, uname. ethname: get name/ethernet-identification of current UNIX .... uname(2) 

log, alog, dlog, clog: Fortran natural logarithm intrinsic function.Jog(3f) 

ncheck: generate names from i-numbers. .ncheck(0) 

anint, dnint, nint, idnint: Fortran nearest integer functions. .round(3f) 

/etc/utab: neighbours known to the Newcastle Connection. . . . utab(5N) 
or trofl. eqn, neqn. checkeq: format mathematical text for nrofl . eqn(l) 

eqnchar special character deflnitions for eqn and neqn.eqnchar(7) 

news: USENET network news article, utility flies.news(3) 

uusub: monitor uucp network.uusub(B) 

mail.nc: mail(l) using the Newcastle Connection instead of uucp.mail(l N) 

/etc/groupmap: user and group id mappings for the Newcastle Connection, /etc/pwmap.pwmap(SN) 

/etc/NCsetup: initialise the Newcastle Connection tables in a process.NCsetup(SN) 

/etc/utab: neighbours known to the Newcastle Connection.utab(5N) 

reconfigure MUNDC. newconf: generate configuration file and.newconf(S) 

newgrp: log in to a new group.newgrp(l) 

news: USENET network news article, utility flies.news{3) 

expire: remove outdated news articles.expire(8) 

inews: submit news articles.Inews(l) 

postnews: submit news articles.postnews(l) 

re ad news: read news articles.readnews(i) 

sendnews: send news articles via mail.sendnews(S) 

uurec: receive processed news articles via mail..uurec(fl) 

checknews: check to see if user has news. .checknews(l) 

news: print news items.news(l) 

news: print news items.news( 1) 

notes, autoseq, nfpipe, nfprint, nfstats: a news system. .notes(l) 

news: USENET network newi article, utility files. . . . news(3) 
mknf, rmnf, nfxmit, nfrev, nfarchive, newsinput, newsoutput: notesflle utility programs. . . notes(8) 

mknf. rmnf. nfxmit, nfrev, nfarchive, newsinput, newsoutput: notesflle utility programs.notes(8) 

checknews(l). newsrc: information file for readnews(l) and.newsrc(5) 

dbminit. fetch, store, delete, flrstkey, nextkey: data base subroutines. .dbm(3X) 

programs, mknf, rmnf, nfxmit, nfrev, nfarchive, newsinput. newsoutput: notesflle utility . . notes(8) 

system, nfcomment: a user interface to the notesflle.nfcomment(3) 

notes, autoseq, nfpipe, nfprint, nf stats: a news system.notes(l) 

notes, autoseq. nfpipe, nfprint. nf stats: a news system.notes(l) 

utility programs, mknf, rmnf, nfxmit, nfrev, nfarchive. newsinput, newsoutput: notesflle . . notes(8) 

notes, autoseq, nfpipe, nfprint, nfstats: a news system.notes(l) 

notesflle utility programs, mknf. rmnf, nfxmit, nfrev, nfarchive, newsinput, newsoutput: . . notes(8) 

nice: change priority of a process.nice(2) 

nice, nohup: run a command at low priority.nice(l) 

alter priority of running process by changing nice, renice:.renice(8) 

anint, dnint, nint. idnint: Fortran nearest integer functions. . . . round(3f) 

nl: line numbering filter.nl(l) 

nlist: get entries from name list. ..nlist(3C) 

nm : print name list.nm(l) 

/etc/mksys: make a remote system node.mksys(6N) 

nice, nohup: run a command at low priority.nice(l) 

setjmp, longjmp: non-local goto.#etjmp(3C) 

functions, and, or, xor, not, lshift, rshift: Fortran bitwise boolean.bool(3f) 

system notes, autoseq. nfpipe. nfprint, nfstats: a news . . . notes(l) 

nfcomment: a user interface to the notesflle system .nfcomment(3) 

nfxmit. nfrev, nfarchive. newsinput. newsoutput: notesflle utility programs, mknf. rmnf.notes(8) 

lcong48: generate/ drand48, erand48, lrand46, nrand48, mrand48, jrand48, srand48, seed48.drand48(3C) 

soelim eliminate .so’s from nrofl input.soelim(l) 

eqn. neqn, checkeq: format mathematical text for nrofl or trofl.eqn(l) 

tbl: format tables for nrofl or trofl.tbl(l) 

eolert: filter nrofl output for CRT previewing.colcrt(l) 

trofl, nrofl: typeset or format text..trofl(l) 

check nr: check nroff/troff flies.checknr(l) 

derofl: remove nrofl/trofl, tbl, and eqn constructs.deroff(l) 

null: the null file.null(4) 

null: the null file.null (4) 

chargefee. ckpacct, dodisk, lastlogin, monacct, nulladm, pretmp. prdaily. prtacct, runacct,/ .... acctsh(8) 

nl: line numbering filter.nl(l) 

size: size of an object file.aize(l) 

lorder: find ordering relation for an object library.lorder(l) 

strings: find the printable strings in a object, or other binary, file.strings(l) 

od : octal dump.od(1) 

od : octal dump.od(l) 

pack : packs or unpacks many flies <—> one.pack(l) 

a program file including aliases and paths (esh only), which: locate.which(l) 

fopen, freopen, fdopen: open a stream .fopen(3S) 

dup: duplicate an open file descriptor.dup(2) 

open: open for reading or writing.open(2) 
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open: open for reeding or writing.open(2) 

tgetstr. tgoto. tputs: terminal Independent operation routine*, tgetent. tgetnum, tgetflag, . . . termcap(3) 

strrehr. strpbrk, strspn, strespn. strtok: string operation*. /itrcpy, stmepy, *trlen. strehr.*tring(3C) 

join: relational database operator.!? in 

dcopy: copy file systems for optimal access time.dcopy(8) 

curse*, screen function* with "optimar cursor motion..curses(3) 

getopt: get option letter from erg*.getopt(3C) 

fcntl: file control option*.fcntl(7) 

atty: set the option* for a terminal.stty(l) 

getopt: parse command option*.getopt(l) 

lpctrl: set option* on the parallel line printer.!pctrl(l) 

boolean functions, and. or. lor. not. lshift, rshift: Fortran bitwise .bool(3f) 

lorder: find ordering relation for an object library.lorder(l) 

ndenod: make a directory, or a special or ordinary We. ... . • ••• •• •.mknod(2) 

ri: screen oriented (visual) display editor based on ex.^(1) 

documents, mosd: the OSDD adapter macro package for formatting .... mo»d(7) 

disk. ot. ox: TU 503/TM 803/TM 703 disk. TU 100-4 floppy ot(4) 

expire: remove outdated news articles..expire(8) 

ecvt, fevt: output conversion. .ecvt(3C) 

fold: fold long lines for finite width output device.fold(l) 

colcrt: Alter nrofl output for CRT previewing.colcrt(l) 

prir.tf, fprintf, sprintf: output formatters.printf(3S) 

commands, acctdisk. acctdusg. accton. acctwtmp: overview of accounting and miscellaneous accounting acct(8) 

chown: change owner and group of a file.chown(2) 

chown. chgrp: change owner or group.chown(l) 

quot: summarize file system ownership.quot(8) 

disk. ot. ox: TU 503/TU 803/TU 703 disk. TU 100-4 floppy . . ot(4) 

pack : packs or unpacks many flies <—> one.pack(l) 

pack : packs or unpacks many files <—> one.pack(l) 

more, page: file perusal filter for ert viewing.more(l) 

tk: p a gin ator for the Tektronix 4014.tk(l) 

me: macros for formatting papers. 

lp : parallel line printer. .lp(4) 

lpctrl: set options on the parallel line printer. .lpctrl(l) 

aetpgrp. getppid: get process, process group, and parent process IDs. getpid.getpid(2) 

a re r ® getopt: parse command options. .getopt(l) 

pc: Pascal compiler.pc(lj 

passwd: change login password.passwd(l) 

passwd: password file.passwd(5) 

setpwuid. getpwnam. setpwent. endpwent: get password file entry, getpwent.getpwent(3C) 

putpwent: write password file entry.putpwent(3C) 

passwd: password file.passwd(5) 

getpass: read a password.getpass(3C) 

passwd: change login password. pas ^x^ 

pwck, grpek: password/group file checkers.pwck(8) 

subsequent lines of one file, paste: merge same lines of several flies or.paste(l) 

getewd: get path-name of current working directory.getcwd(3C) 

which: locate a program file including aliases and paths (esh only).which(l) 

grep. egrep. fgrep: search a file for a pattern..• .. 

awk: pattern scanning and processing language.awk(l) 

pause: suspend process until signal. .pa use (2) 

pc: Pascal compiler.pc(l) 

popen. pc lose: initiate I/O to /from a process.popen(3S) 

Bip: basic functions for BIP, the PCS bitmap display.bip(3) 

mesg : permit or deny messages..mesg(l) 

mptx: the macro package for formatting a permuted index. mp i*( 7 ) 

ptx: permuted index. . ..P^l ) 

acct: per-process accounting file format. .acct(5) 

acctcms: command summary from per-process accounting records..acctcms(8) 

messages, perror, syx-errlist. sysujierr. errno: system error . . perror(3C) 

more, page: file perusal filter for ert viewing.more(l) 

pti: phototypesetter interpreter.pti(l) 

tc: phototypesetter simulator. 

split: split a file into pieces..• • •;. 

pipe: create an interprocess channel.pipers; 

tee: pipe fitting. tee ^!\ 

pipe: Pipes and named pipes..P|P C ) 4 ( 

pipe: Pipes and named pipes..P^®) 4 ' 

pipe: Pipes and named pipes. .• • . P ! P ,t!x 

plock. lock procesa. text, or data in memory.plock(2) 

plot: graphics filters. .plot(lG) 

plot: graphics interface. p [ ol J 5 ) 

plot: graphics interface subroutines..plot(3X) 

lseek: move read/write file pointer.• • • .. 

popen. pclose: initiate 1/0 to/from a process.popen(3S) 

bbp: Basic Block Port Interface.bbp(4) 

sbp. Simplified Basic Block Port Interface. ,bp ^ 4 

prmail: print out mail in the post office.prniail(l) 

banner: make long posters. .banner(5) 
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root functions, exp. log. log 10. 
exp. log. loglO. pow, sqrt; exponential, logarithm. 

bre, bcheckrc. rc, 
bed. 

/ckpacct. dodisk. lastlogin. monacct, nulladm. 
/dodisk. lastlogin, monacct. nulladm, pretmp, 

monitor. 

prep: 

epp: the C language 
colcrt: filter nroff output for CRT 
unget: undo a 
types: 
lpd: line 
lbp: LB P-10 Laser Beam 
lp : parallel line 
Ipctrl: set options on the parallel line 

lpr. line 
vp: Versa tec 

nice, nohup: run a command at low 
nice: change 
renice: alter 

exit, —exit: terminate 
fork: create a new 
inittab: script for the init 
kill: terminate a 
initialise the Newcastle Connection tables in a 
nice: change priority of a 
popen. pclose: initiate I/O to/from a 
getpid. getpgrp. getppid: get 
plock: lock 
wait: await completion of 
checklist: list of file systems 
uurec: receive 

kill: send a signal to a process or a group of 
killall: kill all active 
fuser, identify 
prep: prepare text for statistical 
shutdown: terminate all 
m4: macro 
alarm: set a 


prof: display 
monitor: prepare execution 
profll: execution time 

sh, rsh: shell, the standard/restricted command 

ifprolog: The 
arithmetic: 
true, false: 

/lastlogin, monacct, nulladm, pretmp. prdaily, 
seed48. lcong48: generate uniformly distributed 


ungetc: 
on a stream, 
stream, putc. 


utrr.p file entry, getutent. getutid. getutline. 

putc, putchar, fputc. 


qsort: 


generator, 
ranlib: convert archives to 


postnews: submit news articles..postnews(l) 

pow. sqrt: exponential, logarithm, power, square . . exp(31f) 

power, square root functions..exp(3U) 

powerfail: system initialization shell scripts.brc(8) 

ppt: convert to antique media.bcd(6) 

pr: print files. pr (i) 

prctrr.p. prdaily, prtacct. runacct. shutacct./ .... acctshfS) 
prdaiiy, prtacct, runacct, shutacct, startup,/ .... acctsh(8) 

prep; prepare text for statistical processing.prep(l) 

prepare execution profile.monitor(3C) 

prepare text for statistical processing.prep(l) 

Preprocessor.cpp(l) 

previewing.colcrt(l) 

previous get of an SCCS file.unget(l) 

primitive system data types.types(7) 

printer daemon.lpd(8) 

Printer Interface.lbp(4) 

Printer.i p ( 4 ) 

printer. . ..lpctrl(l) 

printer spooler.lpr(l) 

printer-plotter.vp(4) 

printf, fprintf, sprintf: output formatters.printf(3S) 

Priority.nice(1) 

priority of a process.nice(2) 

priority of running process by changing nice.renice(8) 

prmail: print out mail in the post office.prmail(l) 

process..exit(2) 

process. ..fork(2) 

process..inittab(5) 

process..IriU(I) 

process. /etc/NCsetup:.NCsetup(8N) 

process..nice(2) 

process..popen(3S) 

process, process group, and parent process IDs. . . . getpid(2) 

process, text, or data in memory.p!ock(2) 

process..wait(l) 

processed by fsck.checkiist(5) 

processed news articles via mail.uurec(8) 

processes..lall(2) 

processes..kiUaU(8) 

processes using a file or file structure.fuser(8) 

processing.prep(l) 

processing.ahutdown(8) 

processor. m 4 (i) 

process's alarm clock. .alarm(2) 

prof: display profile data.prof(l) 

profll: execution time profile.profll(2) 

profile data.prof(l) 

Profile.monitor(3C) 

profile..pr oil 1(2) 

profile: setting up an environment at login time. . . . proflle(5) 

programming language.ah(l) 

prolog interpreter system. .ifprolog(l) 

provide drill in number facts.arithmetic(6) 

provide truth values. .true(l) 

prs: print an SCCS file.prs(l) 

prtacct, runacct, shutacct, startup, tumacct:/ . . . acctsh(8) 

ps: process status. .ps(l) 

pseudo-random numbers. /mrand48. jrand48. srand48. drand48(3C) 

pstat: print system facts.pstat(8) 

pti: phototypesetter interpreter.pti(l) 

ptrace: process trace.ptrace(2) 

ptx: permuted index.ptx(l) 

push character back into input stream .ungetc(3S) 

putc. putchar. fputc. putw: put character or word . . putc(3S) 
putchar. fputc. putw: put character or word on a . . putc(3S) 

putpwent: write password file entry.putpwent(3C) 

puts, fputs: put a string on a stream.puts(3S) 

pututline. setutent, endutent, utmpname: access . . getut(3C) 

putw: put character or word on a stream .putc (3 S) 

pwck. grpek: password/group file checkers..pwck(8) 

pwd. working directory name.pwd(l) 

qsort: quicker sort...qsort(3C) 

quicker sort. .qsort(3C) 

quiz: test your knowledge.quiz(6) 

quot: summarize file system ownership.quot(6) ~ 

rand, srand: Fortran uniform random-number .... rand(3f) 

rand, srand: random number generator.rand(3C) 

random libraries. .ranlib(l) 
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rond. irand: random number generator. ran jMf’? 

rand, irand: Fortran uniform random-number generator. •••••••. .2-KWit 

ranlib: convert archives to random libraries.ranlib(l) 

ratfor: rational Fortran dialect.ratforp) 

ratfor: rational Fortran dialect.•.I* ' 

brc bcheckrc, rc. powerfail: system initialization shell scripts. . . . brc(B) 

getpasx read a password.« et P‘*? (3C) 

read: read from ale.***■?/?» 

mail. rmail: send mail to users or readmail. L - . . 

readnews: read news articles. .f* /?\ WI 1 

line: read one line.^ c vW 

read: read from flle. read (2) 

open: open for reading or writing. . • ..open(2) 

readnews: read news articles.re adn ews(l) 

newsrc: information ale for readnews(l) and checknewa(l). 

lseek: move read/write ale pointer. 

char explicit Fortran type/ Lit. ifU. idint. real. Boat, sngl, dble. cmpl*. dcmplx. ichar. .ftype(3f) 

cn ? ' molloc. free, realloc, calloc: main memory allocator.maUoc(3C) 

signal: specify what to do upon receipt of a signal. ....«£>« (;•) 

signal: specify Fortran action on receipt of a system signal. ..«gnaH3f) 

uurec: receive processed news articles via mail.uurec(o) 

recnews: receive unprocessed articles via mail.recnews(l) 

recnews: receive unprocessed articles via mail.recnews(fl) 

recnews: receive unprocessed articles via mail. • . . recnews; 1) 

recnews: receive unprocessed articles via mail. . . . recnews(8) 

newconf: generate conBguration Ble and reconfigure UUKDC . 

command Vimma^ from per-process accounting records, acctcms:. 

fwtmp. wtmpBx: manipulate connect accounting record* \ \\ \\ \\\\\\\\\\\\\\ \ U(l) 

references in documents! refer, lookbib: and and insert literature. 

refer, lookbib: find and insert literature references in documents. rtW.1 ), 

reform: reformat text ale.reformflj 

reform: reformat text flle..reform; 1) 

regemp: regular expression compile.regempu J 

regex, regemp: regular expression compile/execute.regex(3X) 

make: maintain, update, and regenerate groups of programs. ........... make(l) 

regex, regemp: regular expression compile/execute. regex(3X) 
routines, regexp: regular expression compile and match . . regexp(7) 

regexp: regular expression compile and match routines. . . . regexp(7) 

regemp: regular expression compile. rtgcmgll) 

regex, regemp: regular expression compile/execute.regex(3JQ 

comm: select or reject lines common to two sorted flies.comm(l) 

lorder. And ordering relation for an object library... IK' 

unify relational data base system. .unify; 1) 

join: relational database operator.join(l) 

strip: remove symbols and relocation bits. .. 

floor, ceil, fmod, fabs: floor, ceiling, remainder, absolute value functions..floor(3M) 

mod. amod. dmod: Fortran remaindering intrinsic functions..mod(3f) 

leave: remind you when you have to leave.leave(l) 

calendar, reminder service.calendar! 1) 

/etc/usam; initiate a UNIX server for a remote client. u**Wj*) 

usrv: UNIX server for a remote client../avt 

/etc/mkalias: create an alias to a remote flle. . . . . . • •. ™**£f*< * 

rje: RJE (Remote Job Entry) to IBM.. 

✓etc/rmsys: remove a remote system name. 

/etc/mksys: make a remote system node.mksys(8N) 

unite: enable a remote user to access the local system. .uniteJoN) 

rmdel: remove a delta from an SCCS flle.rmdel(l) 

✓etc/rmsys: remove a remote system name.rmsys(eN) 

colrm: remove columns from a flle.colrm;l) 

unlink: remove directory entry.unhnk(2) 

rm. rmdir : remove flies or directories.rm(l) 

derofl: remove nrofl/troll, tbl. and eqn constructs..derofT(l) 

expire: remove outdated news articles. ..expire(8) 

strip: remove symbols and relocation bits..strip(l) 

changing nice, renice: alter priority of running process by .renice(8) 

flle system consistency check and interactive repair, fsek. dfsck: .f*ck(8) 

uniq: report repeated lines m a flle.umq(l; 

yes: be repetitively affirmative. T *»(*) 

sar. system activity reporter.. 

fseek, ftell, rewind: reposition a stream..i 

lock: reserve a terminal. lock v‘ j 

restor: incremental flle system restore.rest or (8) 

restor: incremental flle system restore. .• ;. # . ?LT?j}r\r\ 

getarg: return Fortran command-line argument..geta.g;or; 

getenv. return Fortran environment variable.getenv(3f) 

mclock: return Fortran time accounting.mclock(3f) 

len: return ength of Fortran string. .len(3f) 

index: return location of Fortran substring. ..mdex(3f; 
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•tat: data 

reversi: reversi. a game of dramatic 
col: Alter 
rev. 
reversi: 

fseek. ft ell. 
creat: create a new Ale or 
send: gather Ales and submit 
rje: 

rjestat: 

console. 

rk : RK-11/RK03 or 
hk: RK811/RKC8. 

rk : 
hk: 

rlhl 


hp: RP04/05/06. 

rim 

mail, 

rm. 

newsoutput: notesAle utility programs, mknf, 

chroot: change 
chroot: change 

pow, sqrt: exponential, logarithm, power, square 
sqrt, dsqrt, csqrL Fortran square 
regexp: regular expression compile and match 
tgoto. tputs: terminal independent operation 

hp: 

programming language, sh, 
and. or. xor. not, lshift, 
nice, nohup: 
excr: 
runacct: 

/monacct, nulladm. pretmp, prdaily, prtacct, 
renice: alter priority of 


rz . 

rx : RX01 or 


sal. 
sal. sa2. 


brk. 

bfs: big Ale 
awk: pattern 

ede: change the delta commentary of an 
comb: combine 
delta: make a delta (change) to an 
•act: print current 
get: get a version of an 
prs: print an 
rmdel: remove a delta from an 
sccsdiA: compare two versions of an 
sccsAle: format of 
unget: undo a previous get of an 
val: validate 
admin: create and administer 
what: identify 


clear, clear terminal 
emaca a 
med: 


returned by stat system call.stat(7) 

rev: reverse lines of a Ale.rev(l) 

reversals.reversed) 

reverse line feeds.col(l) 

reverse lines of a Ale.rev(l) 

reversi, a game of dramatic reversals.reversi(O) 

reversi: reversi. a game of dramatic reversals. .... reversi(8) 

rewind: reposition a stream. .fseek(3S) 

rewrite an existing ond.creat(2) 

WSjobs.send(lC) 

RJE (Remote Job Entry) to IBll..rje(fl) 

rje: RJE (Remote Job Entry) to BU.rje(8) 

RJE status report and interactive status console. . . rjestat(lC) 
rjestat: RJE status report and interactive status . . . rjestat(lC) 

rk : RK-11/RK03 or RK05 disk.rk(4) 

RK05 disk.rk(4) 

RK07 moving-head disk.hk(4) 

RK-11/RK03 or RK05 disk.rk(4) 

RK81 1/RK06, RX07 moving-head disk.hk(4) 

rl. hi: RL01/RL02 moving-head disk.rl(4) 

RL01 /RL02 moving-head disk.rl(4) 

rm RU02/03/05 moving-head disk.rm(4) 

rm. rmdir : remove Ales or directories..rm( 1) 

RM02/03 moving-head disk.hp(4) 

RU02/03/05 moving-head disk.rm(4) 

rmail: send mail to users or read mail.mail( 1) 

rmdel: remove a delta from an SCCS Ale.rmdel(l) 

rmdir : remove Ales or directories.rm(l) 

rmnf, nfxmit, nfrev, nfarchive. newsinput,.notes(8) 

rogue: Exploring The Dungeons of Doom..rogue(8) 

raot directory.chroot(2) 

root directory for a command.chroot (8) 

root functions, exp, log, log 10.exp(3U) 

root intrinsic function..sqrt(3f) 

routines.regexp(7) 

routines, tgetent. tgetnum. tgetAag. tgetstr.termcap(3) 

RP04/05/06, RU02/03 moving-head disk.hp(4) 

rsh: shell, the standard/restricted command .... ah(l) 

rshift: Fortran bitwise boolean functions. .bool(3f) 

run a command at low priority.nice( l) 

run a program on another system..excr(lH) 

run daily accounting.runacct(8) 

runacct: run daily accounting.runacct(8) 

runacct, shutacct, startup, tumacct: shell/.acctsh(8) 

running process by changing nice.renice(8) 

rx : RX01 or RX02 Aoppy disk.rx(4) 

RX01 or RX02 Aoppy disk.rx(4) 

RX02 Aoppy disk.rx(4) 

rxctrl: Aoppy disk manipulating program. .rxctrl(l) 

sa. accton: system accounting.sa(8) 

sal. sa2. sadc: system activity report package. . . . aar(8) 

sa2, sadc: system activity report package.sar(8) 

sact: print current SCCS Ale editing activity.sact(l) 

sadc: system activity report package.sar(8) 

sag: system activity graph.,.sag(lG) 

sar: system activity reporter.sar(l) 

sbp: SimpliAed Basic Block Port Interface.sbp(4) 

sbrk: change data segment space allocation.brk(2) 

scanf. fscanf. sscanf: formatted input conversion. . . scanf(3S) 

scanner.bfs(l) 

scanning and processing language.awk(l) 

SCCS delta.cdc(l) 

SCCS deltas..comb(l) 

SCCS Ale.delta(l) 

SCCS Ale editing activity.sact(l) 

SCCS Ale.get(l) 

SCCS Ale.prs(l) 

SCCSAle.rmdel(l) 

SCCSAle.sccsdiA(l) 

SCCS Ale.sccsAle (5) 

SCCS Ale.unget(l) 

SCCS Ale.val(l) 

SCCS Ales.admin(l) 

SCCS Ales.what(l) 

sccsdiA: compare two versons of an SCCS Ale.sccsdiA(l) 

sccsAle: format of SCCS Ale.sccsAle (5) 

screen.clear(l) 

screen editor.emacs(l) 

screen editor.med(l) 
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curses: 
ex. ri: 

inittab: 

rc. do we rf ail: system initialization shell 

•t: 

grep, egrep. fgrep: 

acctcom 
lsearch: linear 
bsearch: binary 
hsearch. hcreate. hdestroy: manage hash 
lsearch. tdelete, twalk: manage binary 
man: print 

/lrand48. nrand4B. mrand48. jrand48. srand48, 
brk, sbrk: change data 
comm: 
cut: cut out 

kill: 

mail, rmail: 
sendnews: 

diction, explain: print wordy 
startrek: THE game based on the t.v. 

/etc/usam initiate a UNIX 
usm UNIX 

/etc/setugi: alter user id of a UNIX 
/etc/stopnc: starts up (closes down) the file 
script: make typescript of terminal 

setuid, 

getgrent. getgrgid, getgmam. 

crypt. 


getpwent. getpwuid. getpwnam, 
profile: 

gettydefs: speed and terminal 

entry, getutent, getutid, getutline, pututline, 
programming language, 
xstr: extract strings from C programs to implement 

system issue a 
system issue a 
esh: a 

prtacct. runacct. shutacct, startup, tumacct: 
brc. bcheckrc, rc. powerfail: system initialization 

language, ah. rsh: 
/nulladm pretmp. prdaily. prtacct. runacct. 

sdifT: 

intrinsic function. 

login. 

pause: suspend process until 
signal: specify what to do upon receipt of a 
specify Fortran action on receipt of a system 

system signal, 
signal, 
kill: send a 
ssignal. gsignal: software 
fmt: 
sbp: 

tc: phototypesetter 
trigonometric functions. 

sin, dsin. csin: Fortran 
sinh, dsinh: Fortran hyperbolic 

function. 

size: 

stctrl.stskip: special streamer features. 


mmt. mvt: typeset documents, view graphs, and 

ttyslot: find the 


screen functions with •optimal'’ cursor motion. . . . curses(3) 

screen oriented (visual) display editor based on . . . vi(l) 

script for the init process.inittab(5) 

script: make typescript of terminal session.scriot(l) 

scripts, brc, bcheckrc.brc(8) 

SCTll Streamer interface.*t(4) 

sdifT: side-by-side difference program .sdiff(l) 

search a file for a pattern.grep(l) 

search and print process accounting flle(s).acctcom(l) 

search and update.!search(3C) 

search.bsearch(3C) 

search tables.hsearch(3C) 

search trees. .tsearch(3C) 

sections of this manual..man(lb) 

sed: stream editor.aed(l) 

seed48, lcong48: generate uniformly distributed/ . . drand48(3C) 

segment space allocation.brk(2) 

select or reject lines common to two sorted flies. . . comm(l) 

selected fields of each line of a file.cut(l) 

send a signal to a process or a group o? processes. . kill(2) 

send: gather flies and submit RJE jobs.send(lC) 

send mail to users or read mail.mail(l) 

send news articles via mail.sendnews(8) 

sendnews: send news articles via mail. .sendnews(8) 

sentences, interactive thesaurus for diction.diction(l) 

series..startrek(6) 

server for a remote client. .usam(8N) 

server for a remote client. .usrv(8N) 

server.* etu « i(8 / ?L 

server spawner. /etc/startnc.startnc(8N) 

session. .script(l) 

setbuf: assign buffering to a stream.setbuf(3S) 

setgid: set user and group IDs.setuid(2) 

setgrent, endgrent: get group file entry.getgrent(3C) 

setjmp, longjmp: non-local goto.setjmp(3C) 

setkey, encrypt: DES encryption..crypt(3C) 

setmnt: establish mount table.eetmnt(8) 

setpgrp: set process group ID.setpgrp(2) 

setpwent. endpwent: get password file entry.getpwent(3C) 

setting up an environment at login time.proflle(5) 

settings used by getty.gettydefs(5) 

setuid. setgid: set user and group IDs. .setuid(2) 

setutent. endutent, utmpname: access utmp file . . . getut(3C) 
sh, rsh: shell, the standard/restricted command . . sh(l) 

shared strings. .xstr(l) 

shell command.system(3S) 

shell command from Fortran..system(3f) 

shell (command interpreter) with C-like syntax. . . . csh(l) 
shell procedures for accounting, /pretmp, prdaily. . acctsh(8) 

shell scripts.krc(8) 

shell, the standard/restricted command programming sh(l) 
shutacct, startup, tumacct: shell procedures for/ . . acctsh(8) 

shutdown: terminate all processing.shutdown(8) 

side-by-side difference program.sdiff(l) 

sign, isdgn, dsign: Fortran transfer-of-sign.sign(3f) 

sign on. .login(l) 

signal. 

•ignal.. • 2) 

signal, signal:.. 

signal: specify Fortran action on receipt of a . . signal(3i) 

signal: specify what to do upon receipt of a .signal(2) 

signal to a process or a group of processes. .kill(2) 

signal a .ssignal (3C) 

simple text formatter.fmt(l) 

Simplified Basic Block Port Interface.»bp(4) 

simulator.^0) 

sin, cos, tan, asin. acos, atan, atan2:.trig(3U) 

sin. dsin. csin: Fortran sine intrinsic function.sin(3f) 

sine intrinsic function.sin(3f) 

sine intrinsic function.“WO 

sinh, cosh, tanh: hyperbolic functions.sinh(3ii) 

sinh, dsinh: Fortran hyperbolic sine intrinsic .... sinh(3f) 

size of an object file.■**(*) 

size: size of an object file.size(l) 

skip flies. .. 

sleep; suspend execution for an interval.sleep(l) 

sleep: suspend execution for interval.. s!ecp(3C) 

slides.•.mmt(l) 

slot in the utmp file of the current user.ttyslot(3C) 
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spline; interpolate 
Fortran type/ int. iAx, idint, real, float. 


signal, gsignal: 

sort: 

qsort: quicker 

tsort: topological 
comm: select or reject lines common to two 
look: And lines in a 
soelim eliminate 
whereis: locate 
indent: indent and format a C program 
mkstr: create an error message Ale by massaging C 
brk. sbrk: change data segment 
expand, unexpand: expand tabs to 
starts up (closes down) the Ale server 
fspec: format 
getty : set terminal type, modes, 
gettydefs: 

spell. 

spell, spellin, spellout: And 
spell, spellin. 

split: 

csplit: context 
frexp, ldexp, modf: 

uuclean: uucp 
lpr. line printer 
printf. fprintf, 
function. 

functions.-exp. log. log 10. pow, 
log 10. pow. sqrt: exponential, logarithm, power, 
sqrt, dsqrt, csqrt; Fortran 
rand, 
rand. 

/erand48. lrand40. nrand48, mrand48, jrand48. 

scanf. fscanf. 


C 

stksdz: set 
boot: 
stdio: 
long: 

sh, rsh: shell, the 

/etc/startnc, /etc/stopnc: 

boot: standalone 
/prctmp, prdaily, prtacct, runacct, shutacct. 


stat: data returned by 
prep: prepare text for 
A: list Ale names and 
ustat: get Ale system 
rjestat: RJE status report and interactive 
ferror. feof, clearerr, flleno: stream 
uustat: uucp 
ps: process 
rjestat: RJE 
stat. fstat: get Ale 
Ales. 


wait: wait for child process to 
subroutines, dbminit, fetch, 
strlen. strchr, strrchr. strpbrk, strspn, strcspn,/ 
/strncat. strcmp, strncmp, strcpy. strncpy, strlen. 

strrchr. strpbrk, strspn./ street, strncat, 
strspn. strcspn,/ street, strncat. strcmp. strncmp, 
strncpy. strlen, strchr, strrchr, strpbrk. strspn. 

sed: 

fclose, ffluah: close or flush a 


smooth curve.spline(IC) 

sngl. dble, empix, dcmplx, ichar, char, explicit .... ftype(3f) 

sno. SNOBOL interpreter.sno(l) 

SN0B0Linterpreter.*. . tno(l) 

soelim eliminate .so's from nroff input.soelim(l) 

software signals.*signal(3C) 

sort or merge Ales.»ort(l) 

• ort .qsort(3C) 

sort: sort or merge Ales.eort(l) 

..tsort(l) 

sorted list..look(l) 

.so‘s from nroff input.soelim(l) 

source, binary, and or manual for program..whereis(l) 

•cure* .indent(l) 

source.mkstr(l) 

space allocation.brk(2) 

spaces, and vice versa.expand(l) 

spawner. /etc/startnc. /etc/stopnc: .startnc(8N) 

speciAcation in text Ales..fspec(5) 

speed, and line discipline.getty(8) 

speed and terminal settings used by getty.gettydefs(5) 

spell, spellin. spellout: And spelling errors..spell(l) 

spellin. spellout: And spelling errors..spell(l) 

spelling errors.spell(l) 

spellout: And spelling errors.spell(l) 

spline: interpolate smooth curve. . . .spline(lC) 

split a Ale into pieces..split(l) 

split-.csplit (1) 

split into mantissa and exponent.frexp(3C) 

split: split a Ale into pieces..split(l) 

spool directory clean-up.uuc!ean(8) 

•pooler.lpr(l) 

sprintf: output formatters.printf(3S) 

sqrt. dsqrt. csqrt: Fortran square root intrinsic . . . sqrt(3f) 
sqrt: exponential, logarithm, power, square root . . . exp(3U) 

square root functions, exp. log.exp(3U) 

square root intrinsic function.sqrt(3f) 

srand: Fortran uniform random-number generator. . rand(3f) 

srand: random number generator.. . rand (3 C) 

srand48. seed48. lcong48: generate uniformly/ . . . drand46(3C) 

sscanf: formatted input conversion. .' scan/(3S) 

ssignal, gsignal: software signals..ssignal(3C) 

st: SCTl 1 Streamer interface.st(4) 

stack frame layout.stack(5) 

stacksixe.stksiz(l) 

standalone startup program..boot(8) 

standard buffered input/output package.stdio (35) 

standard procedures modifled for long arguments. . long(3C) 
standard/restricted command programming language. sh(l) 

startrek: THE game based on the t.v. series.startrek(6) 

starts up (closes down) the Ale server spawner. . . . startnc(8N) 

startup program. .boot(8) 

startup, tumacct: shell procedures for accounting. . acctsh(8) 

stat: data returned by stat system call.stat(7) 

stat. fstat: get Ale status..stat(2) 

stat system call.stat(7) 

statistical processing.prep(l) 

statistics for a Ale system .ff(8) 

statistics.ustat(2) 

status console.rjestat(lC) 

status inquiries.ferror(3S) 

status inquiry and job control.uustat(lC) 

status..ps( 1) 

status report and interactive status console.rjestat(lC) 

status..stat (2) 

stctrl.stskip: special streamer features, skip.stctrl(!) 

stdio: standard buffered input/output package. . . . stdio(3S) 

stime: set time.stime(2) 

stksiz: set stacksixe.stksiz(l) 

stop or terminate.wait(2) 

store, delete. Arstkey, nextkey: data base.dbm(3X) 

streat. strncat, strcmp. strncmp. strcpy. strncpy, . . string(3C) 
strchr. strrchr. strpbrk, strspn. strcspn. strtok:/ . . string (3C) 
strcmp. strncmp, strcpy. strncpy, strlen, strchr. . . . string (3C) 
strcpy. strncpy, strlen. strchr, strrchr, strpbrk. . . . string(3C) 

strcspn. strtok: string operations, /strcpy.string(3C) 

streameditor.»ed(l) 

stream .fclose(3S) 
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fopen. freopen, fdopen: open a stream. .f 2 »VfSSl 

fseek. ftell. rewind: reposition a stream. .. 

getchar. fgete. getw: get character or word from »tream- .. 1 iet*(3S) 

8 get*, fgets: get a string from a atream. ..JS*“Vas» 

putchar. fputc. putw: put character or word on a atream. pu.c. . puts(3S) 

puts, fputs: put a string on a stream. . ^thuffaS) 

setbuf; assign buffering to a atream. .. 

ferror. fcof. clearerr. ftieno: atream atatua ..ferro^ 

ungetc: push character back into input stream. ..,: • ;. 

8 V stctrl.stakip: special streamer features, slep flies.stctrlll) 

at: SCT11 Streamer interface. 

gets, fgets: get a string from a stream..f* fin 

len: return length of Fortran string.“".7-tst 

puts, fputs: put a string on a stream. .. 

::: S5S3 

strings, sstr: extract strings from C programs to implement shared .... wftrU) 

strings: And the printable strings in a object, or other binary, file.«rmgs(l) 

extract string, from C programs to implement.hared ££«»■££ ailiieV ! ! ! ! I .! i • ! ! I ! I I '• ! ba*n«me(l) 

strip: remove symbols and relocation bits..stnpll ; 

-x vsts ^■sssasseiyssarK.:: ss 

/ltremD P ‘strncmp strepr stmepy. strlen. strehr. strrehr. strpbrk. strspn. strespn. str.ok: string/ . . stnng(3C) 
SSS. JS 2 «tAt. itrrehr. itrpbrk. strxpn. strewn, strtok: string operation..«*»«£) 

"sssssrss;::::: £S»’ 

struct: structure Fortran programs. 

fuser: identify processes using a file or file ^ «iiL/ ! ! ! ! ! ! ! ! 1 «tj() 

document, style : analyze surface characteristics of a.style(l) 

su: become super-user or another user. 

inews submit news articles ..inews(l) 

postnews: submit news articles . 

send: gather flies and submit RJS jobs . . ..ISJfcri 

intro: introduction to subroutines and libraries.UwSn 

fetch, store, delete, flrstkey, nextkey: data base mibroutines. ... • > 

plot: graphics interface subroutines.. ..ELV-fn 

paste: merge same lines of several flies or subsequent lmes of one file. £?**hn 

index: return location of Fortran substring. •.••••••• .„,wn 

sum: rum and count blocks m a file.sumU) 

sum: sum and count blocks in a file. 

du: summarize disk usage. . . . . 

quot: summarize file system ownership.. quot( 8 ) 

acctcms: command summary from per-process accounting records. . . . acctcmsW 

sync: update the super block. ,ync >®{ 

sync: update super-block.■***>*' 

su: become super-user or another user. • * u yJ 

style : analyze surface characteristics of a document.styles 1 ) 

sleep: suspend execution for an interval. 

sleep: suspend execution for interval.sleep (3C) 

pause: suspend process until signal. .. 

swab: swap bytes.•*«£(•£) 

swab: swap bytea . . . . 

strip: remove symbols and relocation bits. ..stripll ; 

sync: update super-block..*^ nC /o\ 

sync: update the super block.^ 7 *jc( 8 ) 

esh: a shell (command interpreter) with C-like syntax. . . . • • 1 .^rrirf^ri 

messages, perror. sys_errlist, sys-nerr. errno. system error.perrorjat.; 

perror, sys_errlist, sysL-nerr, errno: system error messages.perror(3C) 

mnttab: mounted file system table. .. JSSmISIO 

/etc/mapu-port—eadr. table of ethernet addresses. ..ethmap(5N) 

configuration information: table of interrupt vector and device addresses . . confhifo(4) 

setmnt: establish mount table.wT?ehf 3 Ci 

hsearch. hcreate. hdestroy: manage hash search tables • • * * ’ -.tblf l) 

tbl: format tables for nrofl or .. 

/etc/KCsetup: initialise the Newcastle Connection tables in a process.tlwii 

* tabs set tabs on a terminal. 

tabs: set tabs on a terminal. 

expand, unexpand: expand tabs to spaces, and vice versa.fffifni 

ctags: create a tags file. • • • .. . * :. * 

tail: deliver the last part of a file../Lin 

functions sin. cos tan. asin. acos. atan. atan 2 : trigonometric. 

tan. dtan: Fortran tangent intrinsic funcUon. .... tanJ3fl 

tan. dtan: Fortran tangent intrinsic function.!* n 82n 

tanh, dtanh: Fortran hyperbolic tangent intrinsic function.tanner; 


February 24. 1984 


-26- 


MUNIX Version 1.5 














































































Permuted Index 


function, 
sixth, cosh, 
tar : 

dumpdir: print the names of files on a dump 

mt: magnetic 
fllesave. 


deroff: remove nroff/troff, 


t search, 

tk: peginator for the 
init, 

tmpfile: create a 
tmpnam: create a name for a 


termcap: 

ctermid: generate file name for 
tgetent, tgetnum, tgetflag, tgetstr, tgoto. tputs: 

termio: general 
tty: controlling 
lock:*reserve a 
tty: get 
clear: clear 
script: make typescript of 
gettydefs: speed and 
stty: set the options for a 
tabs: set tabs on a 
ttyname, isatty: find name of a 
getty : set 

handle special functions of HP 2540 and 2621-series 

kill: 

shutdown: 

abort: 
exit, _exit: 

wait: wait for child process to stop or 


quiz: 

d: 

d: 

ed. red: 
ex: 

reform: reformat 
fspec: format specification in 
eqn. neqn, checkeq: format mathematical 
prep: prepare 
fmt: simple 
plock: lock process, 
troff, nroff: typeset or format 
terminal independent operation routines, 
independent operation routines, tgetent, tgetnum, 
independent operation routines, tgetent, 
operation routines, tgetent. tgetnum, tgetflag, 
routines, tgetent. tgetnum. tgetflag. tgetstr. 
explain: print wordy sentences, interactive 

ttt: 

activity, tirnex: 

time: 

mclock: return Fortran 
at: execute commands at a later 
dcopy: copy file systems for optimal access 

profll: execution 
profile: setting up an environment at login 

stime: set 

time: get 

localtime, gmtime, asetime, txset: convert date and 

clock: report CPU 

times: get process and child process 
utime: set file access and modification 
system activity. 

ot. ox: TU 503/Til 603/TU 703 disk. 

ot. ox: 


tanh. dtanh: Fortran hyperbolic tangent intrinsic . . tanh(3f) 

tanh: hyperbolic functions.. . . . sinh(3U) 

tape archiver.tar<l) 

ta P e ...dumpdir(fl) 

tape manipulating program. .mt(l) 

tapesave: daily/weekly UNIX file system backup. . . . filesave(fl) 

tar : tape archiver.tar(l) 

tbl. and eqn constructs.deroff(l) 

tbl: format tables for nroff or troff.tbl(l) 

tc: phototype setter simulator.tc(l) 

tdelete, twalk: manage binary search trees.Uearch(3C) 

tee: pipe fitting.teefll 

Tektronix 4014.tk(l) 

telinit: process control initialization..init(8) 

temporary file.tmpflle(3S) 

temporary file.tmpnam(3S) 

term: conventional names.term(7) 

termcap: terminal capability data base.termcap(5) 

terminal capability data base.termcap(5) 

terminal. .ctermid(3S) 

terminal independent operation routines.termcap(3) 

terminal interface.termio(4) 

terminal interface.tty(4) 

terminal.lock(l) 

terminal name.tty(l) 

terminal screen..clear(l) 

terminal session. .script(l) 

terminal settings used by getty.gettydefs(5) 

terminal.stty(l) 

terminal.tabs(l) 

terminal .ttyname(3C) 

terminal type, modes, speed, and line discipline. . . . getty(8) 

terminals, hp:.hp(l) 

terminate a process.1011(1) 

terminate all processing.shutdown(8) 

terminate Fortran program. .abort(3f) 

terminate process. .exit(2) 

terminate.wait(2) 

termio: general terminal interface.termio(4) 

test: condition evaluation command.test(l) 

test your knowledge.quiz(6) 

text database functions. .d(l) 

text database functions. .d(3) 

text editor.ed(l) 

text editor.ex(l) 

text file.reform(l) 

text files.fspec(5) 

text for nroff or troff..eqn(l) 

text for statistical processing.prep( 1) 

text formatter.fmt(l) 

text, or data in memory.plock(2) 

text..troff(l) 

tgetent. tgetnum. tgetflag. tgetstr. tgoto. tputs: . . . termcap(3) 

tgetflag. tgetstr. tgoto, tputs: terminal.termcap(3) 

tgetnum. tgetflag, tgetstr. tgoto. tputs: terminal . . . termcap(3) 

tgetstr. tgoto, tputs: terminal independent .termcap(3) 

tgoto. tputs: terminal independent operation .... termcap(3) 

thesaurus for diction, diction, .diction(l) 

tic-tac-toe.ttt(6) 

time a command; report process data and system . . timex(l) 

time a command.time(l) 

time accounting.mclock(3f) 

time.at(l) 

time.dcopy(8) 

time: get time.time(2) 

time profile.profl!(2) 

time.profile(5) 

time.slime (2) 

time: time a command.time(l) 

time.time(2) 

time to ASCII, ctime.ctime(3C) 

time used.clock(3C) 

times: get process and child process times. .times(2) 

times .times(2) 

times .utime(2) 

timex: time a command; report process data and . . timex(l) 

tk: paginator for the Tektronix 4014.tk(l) 

TU 100-4 floppy disk.ot(4) 

TU 503/TU 603/TU 703 disk, TU 100-4 floppy disk. . ot(4) 
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Til-11 /TU-10 magtape interface, TS-11 magtape . . tm(4) 

tmpftie; create a temporary file..tmpAle(3S) 

tmpnam: create a name for a temporary file.tmpnam(35) 

tm,ta: 7M-11 /TU-10 magtape interface. TS-11 magtape tm(4) 

toascii: character translation.conv(3C) 

to/from a process.P°P*”j;~) 

tolower. toascii: character translation.conv(3C) 

topological sort.ttort(l) 

total accounting flies..acctmergto) 

touch: update date last modified of a file. .touch(l) 

toupper, tolower, toascii: character translation. . . . conv(3C) 

tplot: graphics Alters...tpiot(lG) 

tputs: terminal independent operation routines. . . . termcap(3) 

tr: translate characters. . 

trace.*"*•?> 

transfer-of-sign intrinsic function.signer) 

translate characters.**0) 

toupper. tolower. toascii: character translation. . 

ftw. walk a file tree.. 


interface. tm.ts: 


interface, 
toupper. tolower. 
popen. pclose: initiate I/O 
toupper. 
tsort: 

acctmerg: merge or add 


tgetent. tgetnum, tgetflag. tgetstr. tgoto. 

ptrace: process 
sign, isign. dsagn: Fortran 
tr. 


trees. ..tsearch(3C) 

trigonometric functions.trig(3|0 

troff. eqn, neqn. 

troff, nrofl: typeset or format text..tronil) 

troff.. 

troff to the CANON IBP or the Versatec VBO.ltroff(l) 

true, false: provide truth values.true(l) 

truth values. tru *\ | ) 

TS-11 magtape interface.tm^4) 

tsearch, tdelete. twalk: manage binary search .... tsearch(3C) 

tsort: topological sort. 

ttt: tic-tac-toe. tu 8 

tty. controlling terminal interface. u y(4) 

tty: get terminal name. u 7l\) 

TTY-37 type-box.• • • • '.greekf*) 

ttyname. isatty: find name of a terminal.ttyneme(3C) 

ttyslot: find the slot in the utmp file of the ..... ttys!ot(3C) 
prdaily. prtacct. runacct. shutacct. startup, turnacct: shell procedures for accounting, /pretmp. «ccUh(8) 

startrek: THE game based on the t.v series.. . . ..• .. 

tsearch. tdelete. twaU: manage binary search trees..tsearcnt3L) 

type conversion, /ifix, idint. real, float, sngl.ftype(3f) 

type.^ e (l) 

type, modes, speed, and line discipline.getty(8) 

type-box. 

types: primitive system data types..types(7) 

types...types(7) 

typescript of terminal session.script(l) 

typeset documents, view graphs, and slides.mmt(l) 

wwx*. typeset or format text. 

ctime. localtime, gmtime. asetime. tzset: convert date and time to ASCII. .ctime(3C) 

getpw: get name from UID.*?/\ a 3C ' 

ul: do underlining...*■}(*) 

ulimit: get and set user limits.ulimit(2) 

umask: set and get file creation mask.umask(2) 

umask: set file-creation mode mask.umask(l) 

umount: mount and dismount file system.mount(8) 

umount: unmount a file system .umount(2) 

uname. ethname: get name/ethemet-identification of uname(2) 

uname: print name of current UNIX .uname(l) 

uncompact, ccat: compress and uncompress flies, and compact(l) 

uncompress flies, and cat them .compact(l) 

underlining. 

undo a previous get of an SCCS file.unget(l) 

unexpand: expand tabs to spaces, and vice versa. . . expand(l) 

unget: undo a previous get of an SCCS file.unget(l) 

ungetc: push character back into input stream . . . ungetc(3S) 

uniform random-number generator.rand(3f) 

uniformly distributed pseudo-random numbers. . . . drand48(3C) 

unify relational data base system .unify(l) 

uniq: report repeated lines in a file.umq(l) 

unique file name. •••*••• mk . tc ^PX 3C ^ 

unite: enable a remote user to access the local . . . umte(8N) 

units: conversion program. 

UNTX-to-UNDC file copy.uuto(! C 2- 

unlink: exercise link and unlink system calls. .... link(8) 

unlink: remove directory entry.' 

unlink system calls..link(S) 

unmount a file system . ..umount(2) 

unpacks many files <—> one.pack(l) 


tsearch. tdelete. twalk: manage binary search 
sin, cos, tan, asin. acos, a tan. atan2: 
checkeq: format mathematical text for nrofl or 

tbl: format tables for nrofl or 
1 troff, vtrofl: 

true, false: provide 
tmts: TU-11 /TU-10 magtape interface. 

trees. 


greek: graphics for the extended 
current user. 


dble. cmplx, dcmplx. ichar, char: explicit Fortran 

file: determine file 
getty : set terminal 
greek: graphics for the extended TTY-37 

types: primitive system data 
script: make 
mint, mvt: 
troff. nrofl: 


mount, 

current UNIX system 

cat them compact, 
compact, uncompact, ccat: compress and 

ul: do 
unget: 
expand, 


rand, srand: Fortran 
/jrand48, srand48, seed48, lcong48: generate 


mktemp: make a 
system 

uuto. uupick: public 
link. 

link, unlink: exercise link and 
u mount: 
pack : packs or 


recnews 


packs ui uupavM “****•/ _ - v . /.» 

i: receive unprocessed articles via mail.recnewstij 
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recnews: receive 
make: maintain, 
touch: 

lsearch: linear search and 
sync: 
sy nc: 

du: summarize disk 
mmchck: check 
news: 

Connection, /etc/pwmap, /etc/groupmap: 

id: print 
•etuid, setgid: aet 
chfn: change full name of 
cuserid: character login name of the 
group/ getuid, geteuid, getgid, getegid: get real 

environ: 

checknew* check to see if 
/etc/setugi: alter 
Anger, 
nfcomment: a 
ulimit: get and set 
logname: login name of 
geteuid. getgid. getegid: get real user, effective 
su: become super-user or another 
unite: enable a remote 
find the slot in the utmp Ale of the current 
write: write to another 

mail, rmail: send mail to 
wall: write to all 
users: compact list of 
fuser: identify processes 
mail.nc: mail(l) 


new* USENET network news article, 
nfrcv, nfarchive. newsinput, newsoutput: notesAle 

utmp, wtmp: 

pututline. setutent, endutent, utmpname: access 
ttyslot: And the slot in the 

getutid, getutline, pututline, setutent, endutent, 

uucp: 

mail(l) using the Newcastle Connection instead of 

uusub: monitor 
uuclean: 
uustat: 


uucp, 
uucp, uulog, 
uuto. 


vtroff: troff to the CANON LBP or the Versatec 

vaL 

ab* integer absolute 
aba. iabs, dabs, cabs, zabs: Fortran absolute 

getenv: 

f mod. fabs: Aoor, ceiling, remainder, absolute 
true, false: provide truth 
getenv: return Fortran environment 

configuration information: table of interrupt 
lint: a C program 
assert: 

expand, unexpand: expand tabs to spaces, and vice 

vp: 

ltroff, vtroff: troff to the CANON LBP or the 
vfont: font formats for the Benson-Varian or 

vc: 

get: get a 


unprocessed articles via mail.recnews(0) 

update, and regenerate groups of programs.make(l) 

update date last modiAed of a Ale.touch(l) 

.lsearch(3C) 

update super-block..sync(2) 

update the super block. 9 ync(fl) 

uptime: show how long system has been up.uptime(l) 

. .du(l) 

usage of mm macros and eqn delimiters.mmchek(l) 

USENET network news article, utility Ales.news(5) 

user and group id mappings for the Newcastle .... pwmap(5N) 

user and group IDs and names.id(l) 

user and group IDs.setuid(2) 

u~r.chfn(l) 

user .cuserid(3S) 

user, effective user, real group, and effective .... getuid(2) 

user environment.environ(7) 

user has new*.checknews(l) 

user id of a UNIX server.setugi(SN) 

user information lookup program. .Anger(l) 

user interface to the notesAle system.nfcomment(3) 

user limits.ulimit(2) 

user.log name (3X) 

user, real group, and effective group IDs. getuid. . . getuid(2) 

user..eu(l) 

user to access the local system .unite(8N) 

user, ttyslat: .ttyslot(3C) 

user.write(l) 

users: compact list of users who are on the system . users(l) 

users or read maiL .mailfl) 

users.wall(8) 

users who are on the system.users(l) 

using a Ale or Ale structure.fuser(8) 

using the Newcastle Connection instead of uucp.. . . mail(lN) 

usnr. UNIX server for a remote client.usrv(8N) 

ustat: get Ale system statistics.ustat(2) 

utility Ales.news(5) 

utility program* mknf, rmnf, nfxmit.notes(8) 

utime: set Ale access and modiAcation time* .... utime(2) 

utmp and wtmp entry formats.utmp(5) 

utmp Ale entry, getutent. getutid. getutline.getut(3C) 

utmp Ale of the current user.ttyslot(3C) 

utmp, wtmp: utmp and wtmp entry formats.utmp(5) 

utmpname: access utmp Ale entry, getutent.getut(3C) 

uuclean: uucp spool directory clean-up.uuclean(8) 

uucp installation made easy.uucp(8) 

uucp.. mail.nc: .mail(lN) 

uucp network..uusub(8) 

uucp spool directory clean-up.uudean(8) 

uucp status inquiry and job control.uustat(lC) 

uucp: uucp installation made easy.uucp(8) 

uucp, uulog. uuname: Unix to unix copy.uucp (1C) 

uulog. uuname: unix to unix copy.uucp(lC) 

uuname: unix to unix copy.uucp(lC) 

uupick: public UNDC-to-UNDC Ale copy.uuto(lC) 

uurec: receive processed news articles via mail. . . . uurec(8) 

uustat: uucp status inquiry and job control..uustat(lC) 

uusub: monitor uucp network.uusub(8) 

uuto. uupick: public UNDC-to-UNDC Ale copy.uuto(lC) 

uux: unix to unix command execution..uux(lC) 

V0O. ltroff.ltroff(1) 

val: validate SCCS Ale.val(l) 

validate SCC3 Ale.ral(l) 

▼slue.abs(3C) 

value.abs(3f) 

value for environment name.getenv(3C) 

value function* Aoor, ceil.Aoor(3U) 

values..true(l) 

variable.getenv(3f) 

vc: version control.vc(l) 

vector and device addresse* ..conAnfo(4) 

veriAer.lint(l) 

verify program assertion.assert(3X) 

versa.expand(l) 

Versatec printer-pi otter.vp(4) 

Versatec V80.ltroff(l) 

Versatec.vfont(5) 

version control.vc(l) 

version of an SCCS Ale.get(l) 
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sccsdiff: compare two versions of an SCCS ffle. . ••••••'- . 

Versa tec. vfont: font formate for the Benson-vanan or .... vfonUO) 

* fonts, vfontinfo: inspect and print out information about . vfontinfo(l) 
on ex. vi: screen oriented (visual) display editor based . . . vi(l) 
expand, unexpand, expand tabs to spaces, and vice versa. . . . 

mmt, mvt: typeset documents, view grapns, and slides.. ( 

mv: a macro package for making view graphs. 

more, page: file perusal filter for ert viewing. . ;♦•••••• .w,\ 

vi: screen oriented (visual) display editor based on ex. • • • .. 

checking, voicopy. labelit: copy file systems with label.voleopy(O) 

fs: file system format of system volume. ••••••••; . 

vp: Versatec printer-plotter.. vpl*) 

Itroff, vtroff; troff to the CANON LBP or the Versa tec VflO. . ltroff(l) 

w: who is on and what they are doing.*0) 

wait: await completion of process. .) 

wait: wait for child process to stop or terminate.wa:t(2) 

wait: wait for child process to stop or terminate. . . wa:t(2) 

ftw: walk a file tree. 

wall: write to all users. .waL(B) 

wc: word count. 

whatis: describe what a command is.• ; • • ;.whatis(l) 

whatconf: what device drivers are in an umx kernel.whatcon^e; 

what: identify SCCS flies. 

w: who is on and what they are doing. • • • • • • .. "S 1 ] 

signal: specify what to do upon receipt of a signal. 

crash- what to do when the system crashes.crash(8) 

kernel, whatconf: what device drivers are in an unix.whatconf(6) 

whatis: describe what a command is..whatis(1) 

program, whereis: locate source, binary, and or manual for . . whereisjl) 

users: compact list of users who are on the system.. 

whodo: who is doing what.whodo(8) 

from: who is my mail from?...fromtl) 

w. who is on and what they are doing.>."ll) 

who: whe is on the system.' • - • 

who: who is on the system .J 

whodo. who is doing what. iS/ \ 

fold: fold long lines for finite width output device. ................. wld(l) 

diction, explain: print wordy sentences, interactive thesaurus for diction. . diction(l) 

cd: change working directory. ../ 

chdir: change working directory.chd^riZ) 

getewd: get path-name of current working directory.fSrlr ^ 

* pwd: working directory name. 

write: write on a ftle.wnte(2) 

putpwent: write password Ale entry.putpwenttoC) 

wall: writ* t* all ..*■}«•>. 

write: write to another user. wr ^ te >i( 

write: write on a flle.wnte(2) 

write: write to another user.write(l) 

open: open for reading or writing. . .. 

utmp, wtmp: utmp and wtmp entry formats. «... . 

utmp, wtmp: utmp and wtmp entry formats.utmp(5) 

fwtmp. wtmpflx: manipulate connect accounting records. . . fwtmp(8) 

wump: the game of hunt-the-wumpus. .wump(6>- 

command, xargs: construct argument list(s) and execute .... xargs(l) 

xd : hexadecimal dump...*d(l ) 

functions, and. or. xor. not. lshift. rshift: Fortran bitwise boolean .... bool(3f) 

xref : cross-reference listing.^(1) 

shared strings, xstr: extract strings from C programs to implement . x*tr(l) 

jO.jl.jn, yO. yl. yn: Bessel functions..he»« (3M) 

jO.jl.jn.yO, yl. yn: Bessel functions. .bessel(3U) 

yacc: yet another compiler-compiler.yacc(l) 

yes: be repetitively affirmative.Jf 3 i/-iu\ 

j0. jl. jn. yO. yl. yn: Bessel functions. ' 

abs, iabs, dabs. cabs, xabs: Fortran absolute value.abs(3f) 
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NAME 

a68 — MIT assembler 
SYNOPSIS 

a68 [—o objectfile] [—alu] sourcefile 
a68 file.s writes object ’file.o*, or the -0 objectfile*. 
a68 -a writes all symbols, not just globals, in 'file.o*. 
a68 —1 writes a listing on stdout, e.g. 


a68 -1 file.s >file.lis 


a68 -u makes undefined symbols .extern, instead of errors. 



DESCRIPTION 


A68 is the MIT Trix assembler; see /usr/doc/a68. A68 is NOT compatible 
with AS(I); it has no macros, and wants e.g. *movw* instead of 'MOVE* or 
’MOVE.W*. (There is a filter to change Motorola assembler format to A68, 
and another to expand macros). 


SEE ALSO 


/usr/doc/a68 
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NAME 

acctcom - search and print process accounting file(s) 

SYNOPSIS 

acctcom [ [ options ] [ file ] ] . . . 

DESCRIPTION 

Acctcom reads file, the standard input, or /usr/adm/pacct, in the form 
described by acct(5) and writes selected records to the standard output. 
Each record represents the execution of one process. The output shows 
the COMMAND NAME, USER, TTYNAME, START TIME, END TIME, REAL (SEC). CPU 
(SEC), MEAN SIZE(K), and optionally, F (the fork/exec flag: 1 for fork 
without exec) and STAT (the system exit status). 

The command name is prepended with a § if it was executed with super- 
user privileges. If a process is not associated with a known terminal, a ? 
is printed in the TTYNAME field. 

If no files are specified, and if the standard input is associated with a ter¬ 
minal or /dev/null (as is the case when using & in the shell), 
/usr/adm/pacct is read, otherwise the standard input is read. 


If any file arguments are given, they are read in their respective order. 
Each file is normally read forward, i.e., in chronological order by process 
completion time. The file /usr/adm/pacct is usually the current file to 
be examined; a busy system may need several such files of which all but 
the current file are found in /usr/adm/pacct?. The options are: 


-b 

-f 

-h 


-i 

-k 


—m 


—r 


-t 


—1 line 
—u user 


—g group 


Read backwards, showing latest commands first. 

Print the fork/exec flag and system exit status columns in the 
output. 

Instead of mean memory size, show the fraction of total avail¬ 
able CPU time consumed by the process during its execution. 
This "hog factor” is computed as: 

(total CPU time)/(elapsed time). 

Print columns containing the I/O counts in the output. 

Instead of memory size, show total kcore-minutes. 

Show mean core size (the default). 

Show CPU factor (user time/(system-time + user-time). 

Show separate system and user CPU times. 

Exclude column headings from the output. 

Show only processes belonging to terminal /dev/ftne. 

Show only processes belonging to user that may be specified 
by: a user ID, a login name that is then converted to a user ID, 
a § which designates only those processes executed with 
super-user privileges, or ? which designates only those 
processes associated with unknown user IDs. 

Show only processes belonging to group. The group may be 
designated by either the group ID or group name. 


—d mm/dd 


Any time arguments following this flag are assumed to occur 
on the given month mm and the day dd rather than during 
last 24 hours. This is needed for looking at old files. 

—s time Select processes existing at or after time , given in the format 

hr[ :min[ :sec ]]. 
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—e time Select processes existing at or before time. 

—S fime Select processes starting at or after fime. 

—E fime Select processes ending at or before fime. 

—n pattern 

Show only commands matching pattern that may be a regular 
expression as in ed(l) except that + means one or more 
occurrences. 

—o ofile Copy selected process records in the input data format to 

ofile\ supress standard output printing. 

—H factor Show only processes that exceed factor, where factor is the 
"hog factor" as explained in option —h above. 

-O sec Show only processes with CPU system time exceeding sec 
seconds. 

-C sec Show only processes with total CPU time, system plus user, 
exceeding sec seconds. 

Listing options together has the effect of a logical and. 

FILES 

/etc/passwd 

/usr/adm/pacct 

/etc/group 

SEE ALSO 

ps(l), su(l), acct(2), acct(5), utmp(5). 

acct(8), acctcms(8), acctcon(8), acctmerg(8), acctprc(8), acctsh(8), 
fwtmp(8), runacct(8). 

BUGS 

Acctcom only reports on processes that have terminated; use ps(l) for 
active processes. If time exceeds the present time and option —d is not 
used, then fime is interpreted as occurring on the previous day. 
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NAME 

adb — debugger 
SYNOPSIS 

adb [—w] [ objfil [ corfil ] ] 

DESCRIPTION 

Adb is a general purpose debugging program. It may be used to examine 
files and to provide a controlled environment for the execution of UNIX 
programs. 

Objfil is normally an executable program file, preferably containing a 
symbol table; if not then the symbolic features of adb cannot be used 
although the file can still be examined. The default for objfil is a.out. 
Corfil is assumed to be a core image file produced after executing objfil-, 
the default for corfil is core. 

Requests to adb are read from the standard input and responses are to 
the standard output. If the -w flag is present then both objfil and corfil 
are created if necessary and opened for reading and writing so that files 
can be modified using adb. Adb ignores QUIT; INTERRUPT causes return 
to the next adb command. 

In general requests to adb are of the form 

[ address ] [, count ] [ command ] [; ] 

If address is present then dot is set to address. Initially dot is set to 0. 
For most commands count specifies how many times the command will be 
executed. The default count is 1. Address and count are expressions. 

The interpretation of an address depends on the context it is used in. If 
a subprocess is being debugged then addresses are interpreted in the 
usual way in the address space of the subprocess. For further details of 
address mapping see ADDRESSES. 

EXPRESSIONS 

The value of dot. 

+ The value of dot incremented by the current increment. 

~ The value of dot decremented by the current increment. 

" The last address typed. 
integer 

An octal number if integer begins with a 0; a hexadecimal number 
if preceded by f; otherwise a decimal number. 

integer fraction 

A 32 bit floating point number. 

'cccc' The ASCII value of up to 4 characters. \ may be used to escape a 
< name 

The value of name, which is either a variable name or a register 
name. Adb maintains a number of variables (see VARIABLES) named 
by single letters or digits. If name is a register name then the 
value of the register is obtained from the system header in corfil. 
The register names are dO ... d7 aO ... a7 pc ns ac ip. The register 
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names ns, ac and ip deserve special explanation. The register ns is 
the concatenation of the 2 byte exception vector number plus the 
2 byte 68000 cpustate stored during bus or address error excep¬ 
tions. If e.g. the first two bytes of ns are 0002. the program was 
interrupted by a bus error (exception vector 2). The register ac 
contains the access address for a bus or address error exception. 
The register ip is the concatenation of the 2 byte instruction 
register, i.e. the first two bytes of the instruction that caused a 
bus or address error, and the 2 byte processor status. For excep¬ 
tions that are not bus or address error, the second half of ns, all 
of ac, and the first half of ip are 0. 

symbol 

A symbol is a sequence of upper or lower case letters, underscores 
or digits, not starting with a digit. The value of the symbol is 
taken from the symbol table in objfil. An initial _ or ~ will be 
prepended to symbol if needed. 

_ symbol 

In C. the 'true name* of an external symbol begins with It may 
be necessary to utter this name to distinguish it from internal or 
hidden variables of a program. 

routine .name 

The address of the variable name in the specified C routine. Both 
routine and name are symbols. If name is omitted the value is the 
address of the most recently activated C stack frame correspond¬ 
ing to routine. 

{exp ) The value of the expression exp. 

Monadic operators 

•exp The contents of the location addressed by exp in corfil. 

@exp The contents of the location addressed by exp in objfil. 

-exp Integer negation. 
r^exp Bitwise complement. 

Dyadic operators are left associative and are less binding than monadic 
operators. 

el+e2 Integer addition. 
el-e2 Integer subtraction, 
e 1 *e2 Integer multiplication. 
el7*e2 Integer division. 
elSce2 Bitwise conjunction. 
el\e2 Bitwise disjunction. 

el#e2 El rounded up to the next multiple of e2. 

COMMANDS 

Most commands consist of a verb followed by a modifier or list of 
modifiers. The following verbs are available. (The commands '?’ and / 
may be followed by V; see ADDRESSES for further details.) 
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?/ Locations starting at address in objfll are printed according to the 
format /. 

// Locations starting at address in corfil are printed according to the 
format /. 

=/ The value of address itself is printed in the styles indicated by the 
format /. (For i format'?' is printed for the parts of the instruction 
that reference subsequent words.) 

A format consists of one or more characters that specify a style of print¬ 
ing. Each format character may be preceded by a decimal integer that is 
a repeat count for the format character. While stepping through a for¬ 
mat dot is incremented temporarily by the amount given for each format 
Tetter. If no format is given then the last format is used. The format 
letters available are as follows. 

o 2 Print 2 bytes in octal. All octal numbers output by adb are 
preceded by 0. 

0 4 Print 4 bytes in octal, 

q 2 Print in signed octal. 

Q 4 Print long signed octal, 

d 2 Print in decimal. 

D 4 Print long decimal, 

x 2 Print 2 bytes in hexadecimal. 

X 4 Print 4 bytes in hexadecimal, 
u 2 Print as an unsigned decimal number. 

U 4 Print long unsigned decimal. 

f 4 Print the 32 bit value as a floating point number. Currently 
only FFP format supported (see fp( 3)). 

F 8 Print double floating point. For FFP same as above, except 
larger printing format, 
b 1 Print the addressed byte in octal, 
c 1 Print the addressed character. 

C 1 Print the addressed character using the following escape 
convention. Character values 000 to 040 are printed as @ 
followed by the corresponding character in the range 0100 
to 0140. The character @ is printed as 
s n Print the addressed characters until a zero character is 
reached. 

S n Print a string using the @ escape convention, n is the 
length of the string including its zero terminator. 

Y 4 Print 4 bytes in date format (see cfime(3C)). 
i n Print as 68000 instructions, n is the number of bytes occu¬ 
pied by the instruction. This style of printing causes vari¬ 
ables 1 and 2 to be set to the offset parts of the source and 
destination respectively. 

a 0 Print the value of dot in symbolic form. Symbols are 
checked to ensure that they have an appropriate type as 
indicated below. 


/ local or global data symbol 
? local or global text symbol 
= local or global absolute symbol 
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p 2 Print the addressed value in symbolic form using the same 
rules for symbol lookup as a. 

t 0 When preceded by an integer tabs to the next appropriate 
tab stop. For example, 8t moves to the next 8-space tab 
stop. 

r 0 Print a space, 

n 0 Print a newline. 

"..." 0 Print the enclosed string. 

- Dot is decremented by the current increment. Nothing is 
printed. 

+ Dot is incremented by 1. Nothing is printed. 

— Dot is decremented by 1. Nothing is printed. 

newline 

If the previous command temporarily incremented dot, make the 
increment permanent. Repeat the previous command with a count 
of 1. 

[?/]l value mask 

Words starting at dot are masked with mask and compared with 
value until a match is found. If L is used then the match is for 4 
bytes at a time instead of 2. If no match is found then dot is 
unchanged; otherwise dot is set to the matched location. If mask 
is omitted then —1 is used. 

[?/]w value ... 

Write the 2-byte value into the addressed location. If the com¬ 
mand is W, write 4 bytes. Odd addresses are not allowed when writ¬ 
ing to the subprocess address space. 

[?/]m bl el fl[?/] 

New values for (bl, el,fl ) are recorded. If less than three expres¬ 
sions are given then the remaining map parameters are left 
unchanged. If the *?’ or '/’ is followed by V then the second seg¬ 
ment ( b2,e2,f2 ) of the mapping is changed. If the list is ter¬ 
minated by '?’ or V then the file (objfil or corfil respectively) is 
used for subsequent requests. (So that, for example, Vm?’ will 
cause ’/’to refer to objfil.) 

>name 

Dot is assigned to the variable or register named. 

! A shell is called to read the rest of the line following *!'. 

S modifier 

Miscellaneous commands. The available modifiers are: 

</ Read commands from the file / and return. 

>/ Send output to the file /, which is created if it does not 
exist. 

r Print the general registers and the instruction addressed 
by pc. Dot is set to pc. 

b Print all breakpoints and their associated counts and com¬ 
mands. 

c C stack backtrace. If address is given then it is taken as 
the address of the current frame (instead of a6). If C is 
used then the names and (32 bit) values of all automatic 
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and static variables are printed for each active function. If 
count is given then only the first count frames are printed. 
If the module was compiled with the -L option of cc(l), the 
procedure name is followed by the current linenumber. For 
all variables 32 bits are printed, even if the variable is only 
char or short. In this case only the foremost bytes are to be 
considered. For register variables, however, the whole 
register in which the variable resides is printed, and so for 
shorts the last two bytes are the relevant ones! In order to 
help you make the distinction between register and normal 
variables, the latter are prefixed with a "<". 
e The names and values of external variables are printed, 
w . Set the page width for output to address (default 80). 
s Set the limit for symbol matches to address (default 255). 
o All integers input are regarded as octal, 
d Reset integer input as described in EXPRESSIONS, 
q Exit from adb. 

v Print all non zero variables in octal, 

m Print the address map. 

’.modifier 

Manage a subprocess. Available modifiers are: 

be Set breakpoint at address. The breakpoint is executed 
count —1 times before causing a stop. Each time the break¬ 
point is encountered the command c is executed. If this 
command sets dot to zero then the breakpoint causes a 
stop. If the module has been compiled with option -g. see 
cc(l), you can set a breakpoint at line 75 by saying L75:b. 

d Delete breakpoint at address. 

t Run objfiL as a subprocess. If address is given explicitly 
then the program is entered at this point; otherwise the 
program is entered at its standard entry point, counf 
specifies how many breakpoints are to be ignored before 
stopping. Arguments to the subprocess may be supplied on 
the same line as the command. An argument starting with 
< or > causes the standard input or output to be esta¬ 
blished for the command. All signals are turned on on entry 
to the subprocess. 


cs The subprocess is continued with signal s, see signal(2). If 
address is given then the subprocess is continued at this 
address. If no signal is specified then the signal that caused 
the subprocess to stop is sent. Breakpoint skipping is the 
same as for r. 

ss As for c except that the subprocess is single stepped counf 
times. If there is no current subprocess then objfil is run as 
a subprocess as for r. In this case no signal can be sent; 
the remainder of the line is treated as arguments to the 
subprocess. 

k The current subprocess, if any, is terminated. 
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VARIABLES 

Adb provides a number of variables. 
adb but are not used subsequently, 
communication as follows. 


Named variables are set initially by 
Numbered variables are reserved for 


0 The last value printed. 

1 The last offset part of an instruction source. 

2 The previous value of variable 1. 

On entry the following are set from the system header in the corfil. If 
cor fit does not appear to be a core file then these values are set from 
objfil. 

b The base address of the data segment, 

d The data segment size, 

e The entry point. 

m The ‘magic’ number (0405, 0407, 0410 or 0411). 
s The stack segment size, 

t The text segment size. 

ISSES 

The address in a file associated with a written address is determined by a 
mapping associated with that file. Each mapping is represented by two 
triples (bl, el, fl) and (62, e2, f2) and the file address corresponding to a 
written address is calculated as follows. 

6 l^address<e 1 => file address=address+fl—bl, otherwise, 
b2^address<e2 => file address-address-¥f2-b2, 

otherwise, the requested address is not legal. In some cases (e.g. for pro¬ 
grams with separated I and D space) the two segments for a file may 
overlap. If a ? or / is followed by an • then only the second triple is used. 

The initial setting of both mappings is suitable for normal a.out and core 
files. If either file is not of the kind expected then, for that file, bl is set 
to 0, eJ is set to the maximum file size and fl is set to 0; in this way the 
whole file can be examined with no address translation. 

So that adb may be used on large files all appropriate values are kept as 
signed 32 bit integers. 


FILES 

/dev/mem 

/dev/swap 

a.out 

core 

SEE ALSO 

ptrace(2), a.out(5), core(5) 

DIAGNOSTICS , _ . . . 

‘Adb’ when there is no current command or format. Comments about 
inaccessible files, syntax errors, abnormal termination of commands, etc. 
Exit status is 0, unless last command failed or returned nonzero status 


A breakpoint set at the entry point is not effective on initial entry to the 

program. . , 

When single stepping, system calls do not count as an executed 
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instruction. 

Local variables whose names are the same as an external variable may 
foul up the accessing of the external. 


EXAMPLES 

After a core dump: 


adb prog 
Sr 
Sc 
SC 
Se 

bufp/X 

*bufp/X 

write?i 

(cr) 

:b 

:r hello <inp 
main,-l?ia 
data/4X2d 
(cr) 

#100>d0 

<dl=X 

*(<a6+8)/XXX 
write?l #4e75 
:b 


(second parameter core is assumed) 

(print registers) 

(print C stack trace) 

(print full C stack trace) 

(print external variables) 

(print contents of bufp as long hex) 

(print 4 bytes hex where bufp points to) 

(prints first instruction, link a6,...) 

(print next instruction) 

(set breakpoint at this instruction) 

(run prog with param hello and input from inp) 
(disassemble program starting at main) 

(print data: 4 long hex, 2 short decimal) 

(print next data in same format 
(write #100 to register dO) 

(print dl long hex) 

(print first three longs of parameter area) 
(search for rts instruction at end of proc write) 
(set breakpoint at this address) 

(continue program until stop or breakpoint) 
(single step through program 


etc. 


On the 68000, as opposed to the 68010 or 68020, the stack will not neces¬ 
sarily grow automatically. You can recognize a stackoverflow with the fol¬ 
lowing commands: 

adb prog 

Sr 

Sm 


If the value of register ac is less than the value b2 for the second (/) 
map, the stack overflowed. To get the needed stack size, type 
#f00000-<ac=D 

This will output the difference between the top of the stack and the 
access address in decimal. Round the value up some kbyte, and give the 
command 

stksiz prog <value> 
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NAME 

admin — create and administer SCCS files 
SYNOPSIS 

admin [-n] [-i[name]] [-rrel] [-t[name]] [-fflag[flag-val]] 
[—dflag[flag-val]] [-alogin] [-elogin] [-m[mrlist]] [—/[comment]] [-h] 
[—z] files 

DESCRIPTION 

Admin is used to create new SCCS files and change parameters of existing 
ones. Arguments to admin, which may appear in any order, consist of 
keyletter arguments, which begin with -, and named files (note that SCCS 
file names must begin with the characters ».). If a named file doesn't 
exist, it is created, and its parameters are initialized according to the 
specified keyletter arguments. Parameters not initialized by a keyletter 
argument are assigned a default value. If a named file does exist, param¬ 
eters corresponding to specified keyletter arguments are changed, and 
other parameters are left as is. 

If a directory is named, admin behaves as though each file in the direc¬ 
tory were specified as a named file, except that non-SCCS files (last com¬ 
ponent of the path name does not begin with a.) and unreadable files are 
silently ignored. If a name of — is given, the standard input is read; each 
line of the standard input is taken to be the name of an SCCS file to be 
processed. Again, non-SCCS files and unreadable files are silently 
ignored. 


The keyletter arguments are as follows. Each is explained as though only 
one named file is to be processed since the effects of the arguments 
apply independently to each named file. 


—n 


—i[name] 


—rrel 


—t[name] 


This keyletter indicates that a new SCCS file is to be 
created. 

The name of a file from which the text for a new SCCS 
file is to be taken. The text constitutes the first delta 
of the file (see —r keyletter for delta numbering 
scheme). If the i keyletter is used, but the file name is 
omitted, the text is obtained by reading the standard 
input until an end-of-file is encountered. If this 
keyletter is omitted, then the SCCS file is created 
empty. Only one SCCS file may be created by an admin 
command on which the i keyletter is supplied. Using a 
single admin to create two or more SCCS files require 
that they be created empty (no —i keyletter). Note 
that the —i keyletter implies the —n keyletter. 

The release into which the initial delta is inserted. 
This keyletter may be used only if the —i keyletter is 
also used. If the —r keyletter is not used, the initial 
delta is inserted into release 1. The level of the initial 
delta is always 1 (by default initial deltas are named 
1 . 1 ). 

The name of a file from which descriptive text for the 
SCCS file is to be taken. If the —t keyletter is used and 
admin is creating a new SCCS file (the —n and/or —i 
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—fflag 


keyletters also used), the descriptive text file name 
must also be supplied. In the case of existing SCCS 
files: (l) a —t keyletter without a file name causes 
removal of descriptive text (if any) currently in the 
SCCS file, and (2) a —t keyletter with a file name causes 
text (if any) in the named file to replace the descrip¬ 
tive text (if any) currently in the SCCS file. 

This keyletter specifies a flag, and, possibly, a value 
for the flag, to be placed in the SCCS file. Several f 
keyletters may be supplied on a single admin com¬ 
mand line. The allowable flags and their values are: 

b Allows use of the — b keyletter on a flref(l) command to 
create branch deltas. 

, c ceil The highest release (i.e., "ceiling”), a number less than 
or equal to 9999, which may be retrieved by a yef(l) 
command for editing. The default value for an 
unspecified c flag is 9999. 

tfloor The lowest release (i.e., "floor”), a number greater 
than 0 but less than 9999, which may be retrieved by a 
^ef(l) command for editing. The default value for an 
unspecified f flag is 1. 

d SID The default delta number (SID) to be used by a get(l) 
command. 

i Causes the "No id keywords (ge6)" message issued by 
get{l) or delta(l) to be treated as a fatal error. In the 
absence of this flag, the message is only a warning. 
The message is issued if no SCCS identification key¬ 
words (see <7et(l)) ®re found in the text retrieved or 
stored in the SCCS file. 

j Allows concurrent get( l) commands for editing on the 
same SID of an SCCS file. This allows multiple con¬ 
current updates to the same version of the SCCS file. 

Hist A list of releases to which deltas can no longer be 
made (get -e against one of these "locked" releases 
fails). The list has the following syntax: 

<list> ::= <range> | <list> . <range> 

Crange > ::= RELEASE NUMBER | a 

The character a in the list is equivalent to specifying 
all releases for the named SCCS file. 

n Causes delfa(l) to create a "null” delta in each of 
those releases (if any) being skipped when a delta is 
made in a neiw release (e.g.. in making delta 5.1 after 
delta 2.7, releases 3 and 4 are skipped). These null 
deltas serve as "anchor points” so that branch deltas 
may later be created from them. The absence of this 
flag causes skipped releases to be non-existent in the 
SCCS file preventing branch deltas from being created 
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from them in the future. 

q text User definable text substituted for all occurrences of 
the J5QJ5 keyword in SCCS file text retrieved by pet(l). 

nonod Module name of the SCCS file substituted for all 
occurrences of the 7M7, keyword in SCCS file text 
retrieved by flref(l). If the m flag is not specified, the 
value assigned is the name of the SCCS file with the 
leading s. removed. 

t type Type of module in the SCCS file substituted for all 
occurrences of %Y% keyword in SCCS file text retrieved 
by ycf(l). 

vfpflrm] 

Causes delta(l) to prompt for Modification Request 
(MR) numbers as the reason for creating a delta. The 
optional value specifies the name of an MR number 
validity checking program (see delta(l)). (If this flag 
is set when creating an SCCS file, the m keyletter must 
also be used even if its value is null). 

—dflag Causes removal (deletion) of the specified flag from an 

SCCS file. The —d keyletter may be specified only when 
processing existing SCCS files. Several —d keyletters 
may be supplied on a single admin command. See the 
—f keyletter for allowable flag names. 

Mist A list of releases to be “unlocked”. See the —f 
keyletter for a description of the 1 flag and the syntax 
of a list. 

—alogin A login name, or numerical UNIX group ID, to be added 
to the list of users which may make deltas (changes) 
to the SCCS file. A group ID is equivalent to specifying 
all login names common to that group ID. Several a 
keyletters may be used on a single admin command 
line. As many logins, or numerical group IDs, as 
desired may be on the list simultaneously. If the list of 
users is empty, then anyone may add deltas. 

—elogin A login name, or numerical group ID, to be erased from 

the list of users allowed to make deltas (changes) to 
the SCCS file. Specifying a group ID is equivalent to 
specifying all login names common to that group ID. 
Several e keyletters may be used on a single admin 
command line. 

—y[commenf] The comment text is inserted into the SCCS file as a 
comment for the initial delta in a manner identical to 
that of delta(l). Omission of the —y keyletter results 
in a default comment line being inserted in the form: 

date and time created YY/MM/DD HH.MM.SS by login 

The —y keyletter is valid only if the —i and/or —n 
keyletters are specified (i.e., a new SCCS file is being 
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created). 

—m[mriisf] The list of Modification Requests (UR) numbers is 

inserted into the SCCS file as the reason for creating 
the initial delta in a manner identical to delta(l). The 
▼ flag must be set and the UR numbers are validated if 
the ▼ flag has a value (the name of an UR number vali¬ 
dation program). Diagnostics will occur if the ▼ flag is 
not set or UR validation fails. 

—h Causes admin to check the structure of the SCCS file 

(see sccsfile( 5)), and to compare a newly computed 
check-sum (the sum of all the characters in the SCCS 
file except those in the first line) with the check-sum 
that is stored in the first line of the SCCS file. 
Appropriate error diagnostics are produced. 

This keyletter inhibits writing on the file, so that it 
nullifies the effect of any other keyletters supplied, 
and is, therefore, only meaningful when processing 
existing files. 

—z The SCCS file check-sum is recomputed and stored in 

the first line of the SCCS file (see -h, abovd). 

Note that use of this keyletter on a truly corrupted file 
may prevent future detection of the corruption. 


The last component of all SCCS file names must be of the form s .file¬ 
name. New SCCS files are given mode 444 (see e/im.od(l)). Write permis¬ 
sion in the pertinent directory is, of course, required to create a file. All 
writing done by admin is to a temporary x-file, called xjile-name, (see 
gref(l)), created with mode 444 if the admin command is creating a new 
SCCS file, or with the same mode as the SCCS file if it exists. After suc¬ 
cessful execution of admin, the SCCS file is removed (if it exists), and the 
x-file is renamed with the name of the SCCS file. This ensures that 
changes are made to the SCCS file only if no errors occurred. 

It is recommended that directories containing SCCS files be mode 755 and 
that SCCS files themselves be mode 444. The mode of the directories 
allows only the owner to modify SCCS files contained in the directories. 
The mode of the SCCS files prevents any modification at all except by 
SCCS commands. 


If it should be necessary to patch an SCCS file for any reason, the mode 
may be changed to 644 by the owner allowing use of ecf(l). Care must be 
taken! The edited file should always be processed by an admin -h to 
check for corruption followed by an admin —z to generate a proper 
check-sum. Another admin —h is recommended to ensure the SCCS file is 
valid. 

Admin also makes use of a transient lock file (called xflle-name), which 
is used to prevent simultaneous updates to the SCCS file by different 
users. See get(l) for further information. 

,S0 

delta(l), ed(l). get(l). help(l). prs(l). what(l), sccsfile(5). 
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Source Code Control System User's Guide by L. E. Bonanni and C. A. 
Salemi. 

DIAGNOSTICS 

Use help(l) for explanations. 
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NAME 


apropos — locate commands by keyword lookup 
SYNOPSIS 

apropos keyword ... 

DESCRIPTION 

Apropos shows which manual sections contain instances of any of the 
given keywords in their title. Each word is considered separately and 
case of letters is ignored. Words which are part of other words are con¬ 
sidered thus looking for compile will hit all instances of ‘compiler’ also. 
Try 


apropos password 


and 


apropos editor 

If the line starts ’name(section) ...’ you can do 'man section name’ to get 
the documentation for it. Try ‘apropos format* and then ‘man 3s printf' 
to get the manual on the subroutine printf. 

Apropos is actually just the —k option to the man(l) command. 

FILES 

/usr/lib/whatis data base 

SEE ALSO 

man(l), whatis(l). catman(8) 

AUTHOR 

William Joy 
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NAME 

ar — archive and library maintainer 

SYNOPSIS 

ar key [ posname ] afile name ... 

DESCRIPTION 

Ar maintains groups of files combined into a single archive file. Its main 
use is to create and update library files as used by the link editor. It can 
be used, though, for any similar purpose. 

Key is one character from the set drqtpmx, optionally concatenated with 
one or more of vuaibcl. Afile is the archive file. The names are consti¬ 
tuent files in the archive file. The meanings of the key characters are: 

d Delete the named files from the archive file. 

r Replace the named files in the archive file. If the optional charac¬ 
ter u is used with r, then only those files with modified dates later 
than the archive files are replaced. If an optional positioning 
character from the set abi is used, then the posname argument 
must be present and specifies that new files are to be placed after 
(a) or before (b or i) posname. Otherwise new files are placed at 
the end. 

q Quickly append the named files to the end of the archive file. 
Optional positioning characters are invalid. The command does 
not check whether the added members are already in the archive. 
Useful only to avoid quadratic behavior when creating a large 
archive piece-by-piece. 

t • Print a table of contents of the archive file. If no names are given, 
all files in the archive are tabled. If names are given, only those 
files are tabled. 

p Print the named files in the archive. 

m Move the named files to the end of the archive. If a positioning 
character is present, then the posname argument must be present 
and, as in r, specifies where the files are to be moved. 

x Extract the named files. If no names are given, all files in the 
archive are extracted. In neither case does x alter the archive 
file. 

v Verbose. Under the verbose option, ar gives a file-by-file descrip¬ 
tion of the making of a new archive file from the old archive and 
the constituent files. When used with t, it gives a long listing of all 
information about the files. When used with x, it precedes each 
file with a name. 

c Create. Normally ar will create afile when it needs to. The create 
option suppresses the normal message that is produced when afile 
is created. 

1 Local. Normally ar places its temporary files in the directory 
. /tmp. This option causes them to be placed in the local directory. 

FILES 

/tmp/v* temporaries 
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SEE ALSO 

ranlib(l). ld(l). lorder(l). ar(5). 

BUGS 

If the same file is mentioned twice in an argument list, it may be put in 
the archive twice. 
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NAME 

as — assembler 

SYNOPSIS 

as file ... 

DESCRIPTION 

As assembles the named files, which must have the suffix ‘.s'. The output 
of the assembly is left on the corresponding files with suffix ’.o'. Assem¬ 
bler listings are produced on the corresponding files with suffix ’.1st'. 


FILES 


/lib/cpp 

/lib/asm 

/usr/tmp/asm* 

/lib/symfile 

name.s 

name.o 

name.1st 


C preprocessor 
assembler 
temporary files 

used for initialization of /lib/asm 
assembler source 
assembled module 
assembler listing 


SEE ALSO 

Ulrike Weng-Beckmann, Assembler 68000 Users Guide 
Motorola. Macro Assembler Reference Manual 

DIAGNOSTICS 

Diagnostics are given in the assembler listing. 
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NAME 

at — execute commands at a later time 
SYNOPSIS 

at time [ day ] [ file ] 

DESCRIPTION 

At squirrels away a copy of the named file (standard input default) to be 
used as input to s/i(l) at a specified later time. A cd(l) command to the 
current directory is inserted at the beginning, followed by assignments 
to all environment variables. When the script is run, it uses the user and 
group ID of the creator of the copy file. 

The time is 1 to 4 digits, with an optional following *A\ *P'. *N’ or ’M’ for 
AM, PM, noon or midnight. One and two digit numbers are taken to be 
hours, three and four digits to be hours and minutes. If no letters follow 
the digits, a 24 hour clock time is understood. 

The optional day is either (1) a month name followed by a day number, or 
(2) a day of the week; if the word ‘week’ follows invocation is moved seven 
days further off. Names of months and days may be recognizably trun¬ 
cated. Examples of legitimate commands are 

at 8am jan 24 
at 1530 fr week 

At programs are executed by periodic execution of the command 
/usr/lib/atrun from cron( 8). The granularity of at depends upon how 
often atrun is executed. 

Standard output or error output is lost unless redirected. 

FILES 

/usr/spool / at/yy.ddd.hhhh.uu 

activity to be performed at hour hhJih. of year day ddd of year yy. uu is a 
unique number. 

/usr/spool/at/lasttimedone contains hhhh for last hour of activity, 
/usr/spool/at/past directory of activities now in progress 
/usr/lib/atrun program that executes activities that are due 
pwd(l) 

SEE ALSO 

calendar(l), cron(8) 

DIAGNOSTICS 

Complains about various syntax errors and times out of range. 

BUGS 

Due to the granularity of the execution of /usr/lib/atrun, there may be 
bugs in scheduling things almost exactly 24 hours into the future. 
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NAME 

awk — pattern scanning and processing language 
SYNOPSIS 

awk [ -Fc ] [ prog ] [ file ] ... 

DESCRIPTION . , , . 

Awk scans each input file for lines that match any of a set of patterns 
specified in prog. With each pattern in prog there can be an associated 
action that will be performed when a line of a file matches the pattern. 
The set of patterns may appear literally as prog, or in a file specified as 
-l file. 

Files are read in order; if there are no files, the standard input is read. 
The file name —* means the standard input. Each line is matched against 
the pattern portion of every pattern-action statement; the associated 
action is performed for each matched pattern. 

An input line is made up of fields separated by white space. (This default 
can be changed by using FS. vide infra.) The fields are denoted 81, 82, ... 

; 80 refers to the entire line. 

A pattern-action statement has the form 
pattern { action J 

A missing { action \ means print the line; a missing pattern always 
matches. 

An action is a sequence of statements. A statement can be one of the fol¬ 
lowing: 

if ( conditional ) statement [ else statement ] 
while ( conditional) statement 

for ( expression ; conditional; expression ) statement 

break 

continue 

| [ statement ] ... j 

variable = expression 

print [ expression-list ] [ >expression ] 

printf format [ . expression-list ] [ Expression ] 

next # skip remaining patterns on this input line 

exit # skip the rest of the input 

Statements are terminated by semicolons, newlines or right braces. An 
empty expression-list stands for the whole line. Expressions take on 
string or numeric values as appropriate, and are built using the opera¬ 
tors +, * /. %, and concatenation (indicated by a blank). The C opera¬ 

tors ++, —, +=. —=, •=. /=. and %= are also available in expressions. 
Variables may be scalars, array elements (denoted x[i]) or fields. Vari¬ 
ables are initialized to the null string. Array subscripts may be any 
string, not necessarily numeric; this allows for a form of associative 
memory. String constants are quoted 

The print statement prints its arguments on the standard output (or on 
a file if >file is present), separated by the current output field separator, 
and terminated by the output record separator. The printf statement 
formats its expression list according to the format (seeprinf/(3S)). 
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The built-in function length returns the length of its argument taken as 
a string, or of the whole line if no argument. There are also built-in func¬ 
tions exp, log, sqrt, and int. The last truncates its argument to an 
integer. substr(s, m, n) returns the n-character substring of s that 
begins at position m. The function sprint/(fmt, expr, expr, ...) formats 
the expressions according to the printf(3S) format given by fmt and 
returns the resulting string. 

Patterns are arbitrary Boolean combinations (!, ||, Sclc, and parentheses) 
of regular expressions and relational expressions. Regular expressions 
must be surrounded by slashes and are as in egrep. Isolated regular 
expressions in a pattern apply to the entire line. Regular expressions 
may also occur in relational expressions. 

A pattern may consist of two patterns separated by a comma; in this 
case, the action is performed for all lines between an occurrence of the 
first pattern and the next occurrence of the second. 

A relational expression is one of the following: 

expression matchop regular-expression 
expression relop expression 

where a relop is any of the six relational operators in C, and a matchop is 
either ~ (for contains) or !~ (for does not contain). A conditional is an 
arithmetic expression, a relational expression, or a Boolean combination 
of these. 

The special patterns BEGIN and END may be used to capture control 
before the first input line is read and after the last. BEGIN must be the 
first pattern, END the last. 

A single character c may be used to separate the fields by starting the 
program with 

BEGIN ( FS = "c" J 
or by using the —Fc option. 

Other variable names with special meanings include NF, the number of 
fields in the current record; NR. the ordinal number of the current 
record; FILENAME, the name of the current input file; OFS, the output 
field separator (default blank); ORS, the output record separator (default 
newline); and OFMT, the output format for numbers (default "%.6g"). 

EXAMPLES 

Print lines longer than 72 characters: 
length > 72 

Print first two fields in opposite order: 

{ print 82, 81 { 

Add up first column, print sum and average: 

{ s += 81 j 

END j print "sum is", s. " average is", s/NR j 
Print fields in reverse order: 

{ for (i = NF; i > 0; —i) print 8i J 
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Print all lines between start/stop pairs: 

/start/, /stop/ 

Print all lines whose first field is different from previous one: 

81 != prev f print; prev = 81 { 

SEE ALSO 

lex(l), sed(l) 

A. V. Aho, B. W. Kemighan, P. J. Weinberger, Awk - a pattern scanning and 
processing language 

BUGS 

There are no explicit conversions between numbers and strings. To force 
an expression to be treated as a number add 0 to it; to force it to be 
treated as a string concatenate "" to it. 

REMARK 

Awk exists on the CADMUS in 4 different versions: awk.long, awk.ffp, 
awk.mot, awk.nsc. The program awk is linked to awk.ffp. Awk.long is a 
version without floating point, which keeps all variables as long integers. 
The other 3 awks are compiled with the 3 different floating point versions 
(see /p(3)). Awk.nsc will of course only work if your machine is equipped 
with an FPP board. 
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NAME 

basename - strip filename affixes 
SYNOPSIS 

basename string [ suffix ] 

DESCRIPTION 

Basename deletes any prefix ending in V* and the suffix, if present in 
string, from string, and prints the result on the standard output. It is 
normally used inside substitution marks '' in shell procedures. 

This shell procedure invoked with the argument /usr/src/cmd/cat.c 
compiles the named file and moves the output to cot in the current 
directory: 

cc SI 

mv a.out 'basename 81 .c' 

SEE ALSO 

sh(l) 
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NAME 

basic - Basic Interpreter 


STOOPSYS , r . , r , 

basic [ -anrsxtp ] [ +n ] [ fils ] [ plotflle ] [ args ... ] 


DESCRIPTION 

Basic is an ANSI compatible Basic interpreter that runs under UNIX. It is 
written in C so it might not be quite as fast as other Basic interpreters. 


The following options are available: 

—a abort (via IOT trap) on any error. Not for general use. 

—n requires that variable names follow the ANSI standard of a letter 

followed by an optional digit. 

_p (not yet supported) specifies the default plot output file or filter 

to be used for hgr and hplot commands. 

-r causes the file specified to be run. If +n is specified then execu¬ 
tion will start at line n . Basic will exit upon completion of the 
program. 

-t is a debugging option that traces the operation of the interpreter. 

-x is a debugging option that supresses the normal buffering of out¬ 

put. 

file is an optional file name that specifies a program that is to be read 
‘ (or run if -r was specified) before control is passed to the user. 

aros is an option list of arguments that are passed to the program via 
the arg* function. The program may then use the argument 
strings as it sees fit. 


BASIC COMMANDS , ^ . 

The following commands are available to control the running of a Basic 

program or interact with the system: 


/co TTiTnand causes the UNIX command "command to be executed, and 
control to be returned back to Basic. 


AUTO [line l][,line2] causes the program to enter into automatic line 
numbering mode. Line numbering starts at Uriel and increments by 
line2 for each line entered. Automatic numbering mode is terminated by 
a null line, an attention interrupt, or by any error. A star '*•" will be 
printed if an automatically numbered line already exists in the program. 
To delete such a line enter a line with at least one space. 


BYE causes Basic to exit. 

CATALOG prints out the users current file catalog (equivalent to is ). 

CLEAR equivalent to CLEAR VARS plus CLEAR STACK . This is also done 
automatically as part of the RUN command. 

CLEAR VARS clears the variable symbol table. 
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CLEAR STACK clears the execution stack. This is necessary after a "stack 
overflow" error, if Basic statements (such as "print i"), are to be used. 

DEL [lineInline2] deletes linel thru line2 inclusive. It is also possible to 
delete a line by just specifying its line number. 

DUMP displays the contents of the symbol table. This is mainly for 
debugging Basic itself. 

EDIT causes the program in memory to be written out into a scratch file 
and the file editor (SEDITOR shell variable) invoked upon it. Any changes 
made to the program will be reflected in the memory version upon leav¬ 
ing the editor. 

HELP gives you some assistance. If you want more help use man baste. 

LIST [line 1],[line2] causes the program to be listed from lines linel thru 
line2 . The default range is the entire program. 

LOAD is the same as the OLD command. 

MERGE [file] causes the program ill file to be merged with the current 
program in memory. Existing lines will be replaced when duplicate line 
numbers are found. 

MODE [ INT] [ FP] [ UNIX] [ IBM] changes the prompting sequence. 

OLD [file] causes the current program to be discarded, and a new pro¬ 
gram read in from file . Execution hiay then be begun via the RUN com¬ 
mand. Note that all previous variable names are cleared. 

RENUMBER [linel],[line2] causes the program in memory to be renum¬ 
bered, starting at linel , with an increment of line2 . linel defaults to 
10, and line2 to 10. 

RUN [line] causes the program to start execution. If line is specified 
then execution starts at that line number. 

SAVE [file] causes the program in memory to be saved in file . file 
defaults to the last name mentioned in a OLD or SAVE 1 command. 

SCR erases the program and then clears the symbol table. 

TIMEOFF disables TIMEON. 

TIMEON prints time spent in command. 

UNSAVE [file] deletes (unlinks, removes) a file saved via the SAVE com¬ 
mand. 
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BASIC STATEMENTS 

The following Basic statement* may be issued from a stored program or 
as a statement typed in immediate execution mode. 

ASK is the same as the INPUT statement. 

CHAIN fils [.line] replace the current program with the program in the 
file file, and start execution at line lint if present, otherwise at the first 
line of the program. Note that the filt must either be a string expression 
or a string constant. 

CLOSE #n closes unit n. It is quite legal to close a unit that has not been 
opened. When a program begins execution unit 0 is opened for input on 
standard input, and unit 1 is opened for output on standard output. 

DATA constant-list consists of one or more constants separated by com¬ 
mas. Blanks or tabs are not modified in DATA statements. 

DEF FN var(args) - expr causes a function (FN var) to be defined, with 
the given dummy arguments. When FN var(...) appears in an expression 
later the dummy arguments will have real values assigned to them and 
the value of the expression will be returned. 

DIM var (bounds),... each of the variables specified is dimensioned with the 
bounds provided. Basic, as currently configured allows up to two dimen¬ 
sions for each vector variable. Note that a dimensioned variable is dis¬ 
tinct from the scalar variable with the same name (e.g. "a" and "a(i)" are 
different, for all values of "i"). 

END causes the program to terminate. Some Basic’s require that END 
only appear on the last line of a program. 

FOR var = exprl TO expr2 [ STEP txpr3 ] the variable specified is 
assigned the value of expr l, the values of txpr2 and txpr3 (if specified) 
are evaluated and saved. The following statements up to the matching 
next are executed until the value of var is greater than txpr2. When the 
next statement is executed the value expr3 is added to var. expr3 
defaults to 1, and may be negative, in which case the FOP terminates 
when var is less then expr2. 

GET is reserved for future expansion, and will allow input of binary files. 

GOSUB line cause execution to transfer to the line number specified. 
When a RETURN is executed control will continue from the next state¬ 
ment after the GOSUB. 

GOTO line causes execution to transfer to the line number specified. 

IF expr THEN statement If the expression expr is TRUE (non-zero) then 
statement will be executed. Some Basic's only allow a statement number 
or a GOTO statement, but here any legal Basic statement is allowed, 
including another //’statement. Other variations of the IF statement are 
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supported, where THEN is optional, and statement is a line number. 

INPUT [#n,] [string.] var,... the variable (or variables) specified are read 
from the specified unit. If no unit is specified, unit 0 is used. If the 
string is specified it will be used as a prompt, as if printed via a PRINT 
statement. 

LET var=expr assigns the value of expr to the variable var. Note that the 
LET is optional, but should be specified for compatibility with other 
Basics. 

NEXT [var] terminates the preceeding FOP statement. The value of the 
for variable is incremented and if not greater than the limit the execu¬ 
tion continues at the statement following the FOR statement. 

NOTRACE disables the tracing started by the TRACE statement. 

ON expr GOSUB line,... the value of expr is taken as an index into the list 
of line numbers and transfer is made to the n’th line number specified. 
Upon execution of a RETURN statement control will continue from the 
following statement. 

ON expr GOTO line,... the value of expr is taken as an index into the list of 
line numbers and transfer is made to the n’th line number specified. 

OPEN file FOR [ INPUT/OUTPUT/APPEND ] # n opens the file file for either 
input or output on unit n. file may be any string expression. The input 
statement reads (by default) from unit 0. the print statement writes by 
default to unit 1 . APPEND is the same as OUTPUT, but writes at the end 
of the file. 

PRINT [#n,] expr[, ][;]... the value of the expression is printed on the 
specified unit. If no unit is specified then unit 1 is used. It may be either 
a number or a character string. If the comma is specified as a delimiter 
the values will be aligned in fields 16 columns wide. If a semi-colon is 
used there will be no spacing between fields. If there is no delimiter the 
last value will be followed by a new line. A print statement by itself will 
issue a new line. 

PRINT [#n.] USING fmt; expr[,][;]... the value of the expression is printed 
in the same fashion as the PRINT statement, except that the arithmetic 
expression is written according to the format specification fmt. See the 
section PRINT USING FORMAT SPECIFICATIONS. 

RANDOMIZE initializes the random number generator using the internal 
clock. 

READ var,... will read values (from following DATA statements) into the 
variables given. An error will occur if there are insufficient values on 
DATA statements. 

REM causes the following characters to be taken as a remark or 
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comment. Note that the Same effect may be obtained by starting a line 
with either a eingle or double quote. 

RESTORE causes the next READ etatement to etart at the first DATA 
statement in the program. 

RETURN causes control to be transfered to the statement following the 
last GOSUB or ON $xpr GOSUB statement. If there is no enclosing GOSUB 
an error will occur. 

STOP causes the program to terminate with an appropriate comment. 

TRACE causes the line number of each statement to be printed as it is 
executed. This is sometimes helpful in following the execution of a pro¬ 
gram that is not behaving properly. 


In ANSI Basic, a variable must start with a letter, and may have an 
optional digit following. In UNIX Basic although only the first two charac¬ 
ters of a variable name are fcoftSidered significant, an arbitrarily long 
name may be used. The second character does not have to be a digit. 

Following the name either a % (percent) or S (dollar) signs may be 
present. The percent sign indicates that the variable is to hold only 
integer values, while the dollar sign Indicates that the variable is to hold 
string values. If neither is present then the variable will hold real (float¬ 
ing point) values. 


The following standard functions are provided: those marked with an 
asterisk (•) are not ANSI Basic and are a local implementation to facili¬ 
tate communication with the UNIX operating System. 

ABSfvalue) returns the absolute value of the given value. 

ARGSfn) • returns the n'th argument specified when Basic was opened. 
Argument zero is the name of the program file (if any). A null string will 
be returned if an argument is requested that was not specified. This is 
mostly useful when the -r switch is used to run a previously stored pro¬ 
gram. 

ATN(valus) returns the arc-tangent (in radians) function of the given 
value. 

CHRSM returns the ASCII character that corresponds to n. n should 
normally be an integer in the range 0 <= n <= 127. Values in the range 
128 <= n <= 255 are possible. All other values are taken modulo 256. 

COS(angle) returns the cosine function of the given angle in radians. 


DATESQ * returns the current date in the format yy/mm/dd. 
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EXP(value) returns the natural exponent of the given value. 

INTfvalue ) returns the integer value of the given value. 

LEFTS (string,length) the first length characters of the string are 
returned. It is an error if there are not length characters in string. 

LOG(value) returns the natural log of the given value. 

MIDS(string, start, length) the middle length characters of the string 
starting at offset start (1 = first character) are returned. It is an error if 
there are not length characters in string after start. 

RND() returns a random number between 0.0 and 1.0. 

RIGHTS(string,length) the last length characters of the string are 
returned. It is an error if there are not length characters in string. 

SIN (angle ) returns the sine function of the given angle in radians. 

SQR(value) returns the square root of the given value. 

STRS(value) returns a string corresponding to the value. 

SYS(n) • executes system function "n". as follows: 

1 turn off input echoing 

2 turn on input echoing 

3 get one character from keyboard 

4 print symbol table 

5 not implemented 

6 not implemented 

7 exit from Basic interpreter 

SYSTEM (string) • executes string as a system (UNIX) command, and 
returns its exit status. Zero means the command terminated properly. 

TAN(angle ) returns the tangent function of the given angle in radians. 

TIMES() returns the current time in hh:mm:ss format. 

VAL(string) returns a value corresponding to the string. 

OPERATORS 

The following operators are available: 

+ adds two numeric operands together, concatenates two strings, 
subtraction. 
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• multiplication 

/ division 

~ exponentiation 

<> not equal comparison 

= equal comparison, also assignment operator 

< less than comparison 

> greater than comparison 

<= less than or equal comparison 

>= greater than or equal comparison 

AND logical AND of two comparisons 

OR logical OR of two comparisons 

PRINT USING FORMAT SPECIFICATIONS 

The PRINT USING statement format has the following general format 
(where [ and ] enclose optional features): 

[+][••)[**]###[.)###[.]###.##[+] 

The characters have the following meanings 

§ indicates that a digit may be placed here, 
indicates a decimal point 

+ indicates a sign may be placed before (or after) the number. 

•• causes leading zero’s to be replaced with asterisk fill, normally 
blanks are used. 

SS causes a dollar sign to be placed at the start of the number. 

, a comma is inserted into the number if any digits have been 

printed. Unlike some Basic's the position of the commas is 
significant. 

FILES 

/bin/ed default editor 

/tmp/Ba* for the editor temporary file. 

BUGS 

The following features are not implemented: 

■ HAT operations. 

The "PRINT USING" implements only a minimal subset of the nor¬ 
mal facilities. 
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NAME 

be — arbitrary-precision arithmetic language 
SYNOPSIS 

be [ —c ] [ —1 ] [ file ... ] 

DESCRIPTION 

Be is an interactive processor for a language which resembles C but pro¬ 
vides unlimited precision arithmetic. It takes input from any files given, 
then reads the standard input. The -1 argument stands for the name of 
an arbitrary precision math library. The syntax for 6c programs is as fol¬ 
lows; L means letter a-z, E means expression, S means statement. 

Comments 

are enclosed in /• and */. 

Names 

simple variables: L 
array elements: L [ E ] 

The words ‘ibase’, ‘obase’, and ‘scale’ 

Other operands 

arbitrarily long numbers with optional sign and decimal point. 

(E) 

sqrt ( E ) 

length ( E ) number of significant decimal digits 
scale ( E ) number of digits right of decimal point 
L(E.E) 

Operators 

+ — • / % ~ (% is remainder: ~ is power) 

++ — (prefix and postfix: apply to names) 

== <=>=«=<> 

Statements 

E 

i S ;...: S j 
if ( E ) S 
while ( E ) S 
for ( E ; E : E ) S 
null statement 
break 
quit 

Function definitions 

define L ( L.L ) f 

auto L.L 

S; ... S 
return ( E ) 

I 

Functions in —1 math library 
s(x) sine 
c(x) cosine 
e(x) exponential 
l(x) log 
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a(x) arctangent 
j(n,x) Bessel function 

All function arguments are passed by value. 

The value of a statement that is an expression is printed unless the main 
operator is an assignment. Either semicolons or newlines may separate 
statements. Assignment to scale influences the number of digits to be 
retained on arithmetic operations in the manner of dc(l). Assignments 
to ibase or obase set the input and output number radix respectively. 

The same letter may be used as an array, a function, and a simple vari¬ 
able simultaneously. All variables are global to the program. ’Auto' vari¬ 
ables are pushed down during function calls. When using arrays as func¬ 
tion arguments or defining them as automatic variables empty square 
brackets must follow the array name. 

For example 

scale = 20 
define e(x)| 

auto a, b, c, i, s 
a = 1 
b = 1 
s = 1 

for(i=l; 1==1; i++)| 
a = a*x 
b = b*i 
c = a/b 

if(c == 0) return(s) 
s = s+c 

I 

I 

defines a function to compute an approximate value of the exponential 
function and 

for(i=l; i<= 10; i++) e(i) 

prints approximate values of the exponential function of the first ten 
integers. 

Be is actually a preprocessor for <£c(l), which it invokes automatically, 
unless the —c (compile only) option is present. In this case the dc input 
is sent to the standard output instead. 

FILES 

/usr/lib/lib.b mathematical library 
dc(l) desk calculator proper 

SEE ALSO 

dc(l) 

L. L. Cherry and R. Morris, BC — An arbitrary precision desk-calculator 
language 

BUGS 

No &&, 11, or ! operators. 

For statement must have all three E’s. 

Quit is interpreted when read, not when executed. 
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NAME 

bdiff — big diff 
SYNOPSIS 

bdiff filel file2 [n] [—s] 

DESCRIPTION 

Bdiff is used in a manner analogous to diff(l) to find which lines must be 
changed in two files to bring them into agreement. Its purpose is to allow 
processing of files which are too large for diff. Bdiff ignores lines com¬ 
mon to the beginning of both files, splits the remainder of each file into 
n-line segments, and invokes diff upon corresponding segments. The 
value of n is 3500 by default. If the optional third argument is given, and 
it is numeric, it is used as the value for n. This is useful in those cases in 
which 3500-line segments are too large for diff, causing it to fail. If filel 
(fiLe2) is —, the standard input is read. The pptional —a (silent) argument 
specifies that no diagnostics are to be printed by bdiff (note, however, 
that this does not suppress possible exclamations by diff. If both 
optional arguments are specified, they must appear in the order indi¬ 
cated above. 

The output of bdiff is exactly that of diff, with line numbers adjusted to 
account for the segmenting of the files (that is, to make it look as if the 
files had been processed whole). Note that because of the segmenting of 
the files, bdiff does not necessarily find a smallest sufficient set of file 
differences. 

FILES 

/tmp/bd????? 

SEE ALSO 

diff(l). 

DIAGNOSTICS 

Use A.elp(l) for explanations. 
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NAME 

bfs — big file scanner 

SYNOPSIS 

bfs [ — ] name 

DESCRIPTION 

Bfs is (almost) like ed(l) except that it is read-only and processes much 
larger files. Files can be up to 1024K bytes (the maximum possible size) 
and 32K lines, with up to 255 characters per line. Bfs is usually more 
efficient than ed for scanning a file, since the file is not copied to a 
buffer. It is most useful for identifying sections of a large file where 
csplit(l) can be used to divide it into more manageable pieces for edit¬ 
ing. 

Normally, the size of the file being scanned is printed, as is the size of 
any file written with the w command. The optional — suppresses printing 
of sizes. Input is prompted with • if P and a carriage return are typed as 
in ed. Prompting can be turned off again by inputting another P and car¬ 
riage return. Note that messages are given in response to errors if 
prompting is turned on. 

All address expressions described under ed are supported. In addition, 
regular expressions may be surrounded with two symbols besides / and ?: 
> indicates downward search without wrap-around, and < indicates 
upward search without wrap-around. Since bfs uses a different regular 
expression-matching routine from ed, the riegular expressions accepted 
are slightly wider in scope (see regex( 3X)). There is a slight difference in 
mark names: only the letters a through z may be used, and all 26 marks 
are remembered. 

The e, g, v, k, n, p. q. w. =. ! and null commands operate as described 

under ed. Commands such as -, +++—, +++=, —12. and +4p are 

accepted. Note that l.lOp and 1,10 will both print the first ten lines. The 
f command only prints the name of the file being scanned; there is no 
remembered file name. The w command is independent of output diver¬ 
sion. truncation, or crunching (see the xo, xt and xc commands, below). 
The following additional commands are available: 

xf file 

Further commands are taken from the named file. When an 
end-of-file is reached, an interrupt signal is received or an 
error occurs, reading resumes with the file containing the xf. Xf 
commands may be nested to a depth of 10. 

xo [file ] 

Further output from the p and null commands is diverted to the 
named file, which, if necessary, is created mode 666. If file is 
missing, output is diverted to the standard output. Note that 
each diversion causes truncation or creation of the file. 

:label 

This positions a label in a command file. The label is ter¬ 
minated by new-line, and blanks between the : and the start of 
the label are ignored. This command may also be used to insert 
comments into a command file, since labels need not be refer¬ 
enced. 
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( . , . )xb /regular expression/Label 

A jump (either upward or downward) is made to label if the com¬ 
mand succeeds. It fails under any of the following conditions: 

1. Either address is not between 1 and S. 

2. The second address is less than the first. 

3. The regular expression doesn’t match at least one line 
in the specified range, including the first and last lines. 

On success, . is set to the line matched and a jump is made to 
Label. This command is the only one that doesn't issue an error 
message on bad addresses, so it may be used to test whether 
addresses are bad before other commands are executed. Note 
that the command 

xb/~/ label 

is an unconditional jump. 

The xb command is allowed only if it is read from someplace 
other than a terminal. If it is read from a pipe only a downward 
jump is possible. 

xt number 

Output from the p and null commands is truncated to at most 
number characters. The initial number is 255. 

xv[ digit ] [ spac es ] [ value ] 

The variable name is the specified digit following the xv. xv5100 
or xv5 100 both assign the value 100 to the variable 5. 
Xv61,l00p assigns the value l.lOOp to the variable 6. To refer¬ 
ence a variable, put a % in front of the variable name. For 
example, using the above assignments for variables 5 and 6: 


l,%5p 

1,555 

%6 

will all print the first 100 lines. 
g/%5/p 

would globally search for the characters 100 and print each line 
containing a match. To escape the special meaning of 55, a \ 
must precede it. 

g/".*\ %[cds]/p 

could be used to match and list lines containing printf of char¬ 
acters, decimal integers, or strings. 

Another feature of the xv command is that the first line of out¬ 
put from a UNIX command can be stored into a variable. The 
only requirement is that the first character of value be an !. 
For example: 

xv5!cat junk 
!rm junk 
!echo "555" 
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xv6!expr X6 + 1 

would put the current line into variable 5, print it, and incre¬ 
ment the variable 6 by one. To escape the special meaning of ! 
as the first character of value, precede it with a \. 

xv7\ !date 

stores the value idate into variable 7. 
xbz label 

xbn label 

These two commands will test the last saved return code from 
the execution of a UNIX command (Icommand) or nonzero value, 
respectively, to the specified label. The two examples below 
both search for the next five lines containing the string size. 

xv55 
: 1 

/size/ 

xv5!expr %5 — 1 
!if 0%5 != 0 exit 2 
xbn 1 
xv45 
: 1 

/size/ 

xv4!expr %4 — 1 
!if 0%4 = 0 exit 2 
xbz 1 

xc [suafc/i] 

If switch is 1, output from the p and null commands is 
crunched; if switch is 0 it isn’t. Without an argument, xc rev¬ 
erses switch. Initially switch is set for no crunching. Crunched 
output has strings of tabs and blanks reduced to one blank and 
blank lines suppressed. 

SEE ALSO 

csplit(l), ed(l), regex(3X). 

DIAGNOSTICS 

? for errors in commands, if prompting is turned off. Self-explanatory 
error messages when prompting is on. 
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NAME 

bs — a compiler/interpreter for modest-sized programs 

SYNOPSIS 

bs [ file [ args ] ] 

DESCRIPTION 

Bs is a remote descendant of Basic and Snobol4 with a little C language 
thrown in. Bs is designed for programming tasks where program 
development time is as important as the resulting speed of execution. 
Formalities of data declaration and file/process manipulation are minim¬ 
ized. Line-at-a-time debugging, the trace and dump statements, and 
useful run-time error messages all simplify program testing. Further¬ 
more, incomplete programs can be debugged; inner functions can be 
tested before outer functions have been written and vice versa. 

If the command line file argument is provided, the file is used for input 
before the console is read. By default, statements read from the file 
argument are compiled for later execution. Likewise, statements entered 
from the console are normally executed immediately (see compile and 
execute below). Unless the final operation is assignment, the result of an 
immediate expression statement is printed. 

Bs programs are made up of input lines. If the last character on a line is 
a \. the line is continued. Bs accepts lines of the following form: 

statement 
label statement 

A label is a name (see below) followed by a colon. A label and a variable 
can have the same name. 

A bs statement is either an expression or a keyword followed by zero or 
more expressions. Some keywords (clear, compile, !, execute, include, 
ibase, obase, and run) are always executed as they are compiled. 

Statement Syntax: 

expression 

The expression is executed for its side effects (value, assignment or 
function call). The details of expressions follow the description of 
statement types below. 

break 

Break exits from the inner-most for /while loop, 
clear 

Clears the symbol table and compiled statements. Clear is executed 
immediately. 

compile [ expression ] 

Succeeding statements are compiled (overrides the immediate execu¬ 
tion default). The optional expression is evaluated and used as a file 
name for further input. A clear is associated with this latter case. 
Compile is executed immediately. 

continue 

Continue transfers to the loop-continuation of the current for /while 
loop. 
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! shell command 

An immediate escape to the Shell. 

# ... 

This statement is ignored. It is used to interject commentary in a pro¬ 
gram. 

Expression Syntax: 
name 

A name is used to specify a variable. Names are composed of a letter 
(upper or lower case) optionally followed by letters and digits. Only 
the first six characters of a name are significant. Except for names 
declared in fun statements, all names are global to the program. 
Names can take on numeric (double float) values, string values, or can 
be associated with input/output (see the built-in function open() 
below). 

name ( [expression [ , expression] ... ] ) 

Functions can be called by a name followed by the arguments in 
parentheses separated by commas. Except for built-in functions 
(listed below), the name must be defined with a fun statement. Argu¬ 
ments to functions are passed by value. 

name [ expression [ . expression ] ... ] 

This syntax is used reference either arrays or tables (see built-in table 
functions below). For arrays, each expression is truncated to an 
integer and used as a specifier for the name. The resulting array 
reference is syntactically identical to a name; a[l.2] is the same as 
a[l][2]. The truncated expressions are restricted to values between 0 
and 32767. 

number 

A number is used to represent a constant value. A number is written 
in Fortran style, and contains digits, an optional decimal point, and 
possibly a scale factor consisting of an e followed by a possibly signed 
exponent. 

string 

Character strings are delimited by " characters. The \ escape char¬ 
acter allows the double quote (V'). new-line (\n). carriage return 
(\r), backspace (\b), and tab (\t) characters to appear in a string. 
Otherwise, \ stands for itself. 

( expression ) 

Parentheses are used to alter the normal order of evaluation. 

( expression, expression [. expression ...])[ expression ] 

The bracketed expression is used as a subscript to select a comma- 
separated expression from the parenthesized list. List elements are 
numbered from the left, starting at zero. The expression: 

( False, True )[ a == b ] 
has the value True if the comparison is true. 

? expression 

The interrogation operator tests for the success of the expression 
rather than its value. At the moment, it is useful for testing end-of- 
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if expression statement 
if expression 


[ else 
fi 


] 


The statement (first form) or group of statements (second form) is 
executed if the expression evaluates to non-zero. The strings 0 and 
(null) evaluate as zero. In the second form, an optional else allows for 
a group of statements to be executed when the first group is not. The 
only statement permitted on the same line with an else is an if; only 
other fi' s can be on the same line with a fi. The elision of else and if 
into an elif is supported. Only a single fi is required to close an if ... 
elif ... [ else ... ] sequence. 

include expression 

The expression must evaluate to a file name. The file must contain os 
Such statements become part of the program being compiled, source 
statements. Include statements may not be nested. 

obase N 

Obase sets the input base to N (see ibase above). 

onintr label 
nnintr 

The oninfr command provides program control of interrupts. In the 
first form, control will pass to the label given, just as if a goto had 
been executed at the time onintr was executed. The effect of the 
statement is cleared after each interrupt. In the second form, an 
interrupt will cause bs to terminate. 

return [expression] 

The expression is evaluated and the result is passed back as the value 
of a function.call. If Tio expression is given, zero is returned. 


run 


The random number generator is reset. Control is passed to the first 
internal statement. If the run statement is contained in a file, it 
should be the last statement. 


stop 


Execution of internal statements is stopped, 
mode. 


Bs reverts to immediate 


trace [ expression ] 

The trace statement controls function tracing. If the expression is 
null (or evaluates to zero), tracing is turned off. Otherwise, a record 
of user-function calls/returns will be printed. Each return decre¬ 
ments the trace expression value. 

while expression statement 
while expression 


next 

While is similar to for except that only the conditional expression for 
loop-continuation is given. 
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Exponentiation. 
Built-in Functions: 


Dealing with arguments 

arg(i) 

is the value of the i-th actual parameter on the current level of func¬ 
tion call. At level zero, arg returns the t-th command-line argument 
(arg(O) returns bs). 

narg( ) 

returns the number of arguments passed. At level zero, the command 
argument count is returned. 


Mathematical 


abs(x) 

is the absolute value of x. 


atan(x) 

is the arctangent of x. Its value is between -tt/ 2 and rr/2. 
ceO(x) 

returns the smallest integer not less than x. 
cos(x) 

is the cosine of x (radians). 
exp(x) 

is the exponential function of x. 
floor(x) 

returns the largest integer not greater than x. 
log(x) 

is the natural logarithm of x. 
rand() 

is a uniformly distributed random number between zero and one. 
sin(x) 

is the sine of x (radians). 
sqrt(x) 

is the square root of x. 


String operations 

size(s) 

the size (length in bytes) of s is returned. 
format(f, a) 

returns the formatted value of a. F is assumed to be a format 
specification in the style of printf{ 3S). Only the and 

%...s types are safe. 

index(x, y) 

returns the number of the first position in x that any of the charac¬ 
ters from y matches. No match yields zero. 

trans(s, f, t) 

Translates characters of the source s from matching characters in / 
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file (see examples in the Programming Tips section below), the result 
of the eval built-in function, and for checking the return from user- 
written functions (see /return). An interrogation “trap” (end-of-file, 
etc.) causes an immediate transfer to the most recent interrogation, 
possibly skipping assignment statements or intervening function lev¬ 
els. 

— expression 

The result is the negation of the expression. 

++ name 

Increments the value of the variable (or array reference). The result 
is the new value. 

— name 

Decrements the value of the variable. The result is the new value. 

! expression 

The logical negation of the expression. Watch out for the shell escape 
command. 

expression operator expression 

Common functions of two arguments are abbreviated by the two argu¬ 
ments separated by an operator denoting the function. Except for the 
assignment, concatenation, and relational operators, both operands 
are converted to numeric form before the function is applied. 

Binary Operators (in increasing precedence): 

= is the assignment operator. The left operand must be a name or an 
array element. The result is the right operand. Assignment binds 
right to left, all other operators bind left to right. 

_(underscore) is the concatenation operator. 

& I 

It (logical and) has result zero if either of its arguments are zero. It 
has result one if both of its arguments are non-zero; | (logical or) has 
result zero if both of its arguments are zero. It has result one if either 
of its arguments is non-zero. Both operators treat a null string as a 
zero. 

<= > >= == != 

The relational operators (< less than. <= less than or equal. > greater 
than, >= greater than or equal, == equal to, '!= not equal to) return 
one if their arguments are in the specified relation. They return zero 
otherwise. Relational operators at the same level extend as follows: 
a>b>c is the same as a>6 & 6>c. A string comparison is made if both 
operands are strings. 

Add and subtract. 

/ 7. 

Multiply, divide, and remainder. 
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The item function accesses table elements sequentially (in normal 
use. there is no orderly progression of key values). Where the xtem 
function accesses values, the key function accesses the subscript of 
the previous item call. The name argument should not be quoted. 
Since exact table sizes are not defined, the interrogation operator 
should be used to detect end-of-table, for example. 

table("t". 100) 

# If word contains "party", the following expression adds one to 

the count 

# of that word: 

++t[word] 


# To print out the the key/value pairs: 
for i = 0. ?(s = item(t, i)). ++i if key() 


put = key()_":"_s 


iskey(name, word ) , , 

The iskey function tests whether the key 
name and returns one for true, zero for false 

Odds and ends 


word exists in the table 


CV The string argument is evaluated as a bs expression. The function is 
handy for converting numeric strings to numeric internal form. a 
can also be used as a crude form of indirection, as in. 


name = ”xyz M 
eval( M ++ M _ name) 

which increments the variable xyz. In addition, eval preceded by the 
interrogation operator permits the user to control 6s error condi¬ 
tions. For example: 

?eval("open(\"X\", \"XXXV\ V'rVT) 

returns the value zero if there is no file named “XXX” (instead of halt¬ 
ing the user’s program). The following executes a goto to the label L 

(if it exists): 


label=”L” 

if !(?eval(”goto "_ label)) puterr = "no label" 


Pl °ThTp?oMun?Uon produces output on devices recognized by fpiof(lG). 
The requests are as follows: 


Call 

plot(0, term) 


Function 

causes further plot output to be piped 
into tplot(lG) with an argument of 
—Tferm. 


plot(l) 

plot(2, string) 
plot(3, xl. yl. x2, y2) 


"erases” the plotter, 
labels the current point with string. 
draws the line between (xl.yl) and 
( x2,y2 ). 
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to a character in the same position in t. Source characters that do 
not appear in / are copied to the result. If the string / is longer than 
t, source characters that match in the excess portion of / do not 
appear in the result. 

substr(s, start, width) 

returns the sub-string of s defined by the starting position and width.. 

match(string, pattern) 
mstring(n) 

The pattern is similar to the regular expression syntax of the ec£(l) 
command. The characters ., [. ], ~ (inside brackets). • and S are spe¬ 
cial. The mstring function returns the n-th (1 <= n <= 10) substring 
of the subject that occurred between pairs of the pattern symbols \ ( 
and \) for the most recent call to match. To succeed, patterns must 
match the beginning of the string (as if all patterns began with 
The function returns the number of characters matched. For exam¬ 
ple: 

match("a 123ab 123", *'.*\ ([a-z]\ )") == 6 
mstring(l) == ”b” 

File handling 

open(name, file, function) 
close(name) 

The name argument must be a bs variable name (passed as a string). 
For the open, the file argument may be l) a 0 (zero). 1. or 2 
representing standard input, output, or error output, respectively. 2) 
a string representing a file name, or 3) a string beginning with an ! 
representing a command to be executed (via sh -c). The function 
argument must be either r (read), w (write). W (write without new-line), 
or a (append). After a close, the name reverts to being an ordinary 
variable. The initial associations are: 

open("get", 0. "r") 
openC’put". 1, "yf") 
open(”puterr", 2, "w”) 

Examples are given in the following section. 

access(s, m) 

executes access{ 2). 


ftype(s) 

returns a single character file type indication: f for regular file, d for 
directory, b for block special, or c for character special. 


Tables 

table(name, size) 

A table in bs is an associatively accessed, single-dimension array. 
“Subscripts” (called keys) are strings (numbers are converted). The 
name argument must be a 6s variable name (passed as a string). The 
size argument sets the minimum number of elements to be allocated. 
Bs prints an error message and stops on table overflow. 


item(name, i) 
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§ compute: 
while ?(str = read) 


next 

# clean up: 
close("read") 

§ last statement executed (exit or stop): 
exit 

rff last input line: 
run 

Input/Output examples: 

| Copy "oldfile" to "newfile". 
openC’read". "oldfile". V) 
openC'write", "newfile". "w”) 


while ?(write = read) 


# close "read" and "write": 

close("read") 

close("write") 


# Pipe between commands. 
open("ls", "!ls "r") 
open("pr”. "!pr -2 -h 'List'", "w") 
while ?(pr = Is) ... 


£ be sure to close (wait for) these: 

close("ls") 

close("pr”) 

SEE ALSO 

ed(l), sh(l), tplot(lG). access(2). printf(3S). stdio(3S), Section 3 of this 
volume for further description of the mathematical functions (pow(3M) is 
used for exponentiation). plot(5). Bs uses the Standard Input/Output 
package. 

Bs exists in 3 different versions on the CADMUS: bs.ffp. bs.mot and bs.nsc. 
The name bs is linked to bs.ffp. These three programs are compiled with 
the 3 different floating point versions of cc. see/p(3). 
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plot(4, x, y, r) 


draws a circle with center (x.y) and 
radius r. 


plot(5, xl, yl, x2, y2, x3, y3) 

draws an arc (counterclockwise) with 
center ( xl.yl ) and endpoints ( x2,y2 ) 
and ( x3,y3 ). 

plot(6) is not implemented. 

plot(7, x, y) makes the current point {x.y). 


plot(8, x. y) 


draws a line from the current point to 

(*.y)- 


plot(9, x. y) 
plot(lO, string) 
plot(l 1. xl, yl, x2, y2) 


plot(l2, xl, yl. x2, y2) 


draws a point at (x.y). 
sets the line mode to string. 

makes {xl.yl) the lower left corner of 
the plotting area and {x2,y2) the upper 
right corner of the plotting area. 

causes subsequent x (y) coordinates to 
be multiplied by xl {yl) and then added 
to x2 {y2) before they are plotted. The 
initial scaling is plot(l2. 1.0. 1.0. 0.0. 
0 . 0 ). 


Some requests do not apply to all plotters. All requests except zero 
and twelve are implemented by piping characters to tplot(lG). See 
plot {5) for more details. 

last() 

in immediate mode, last returns the most recently computed value. 


PROGRAMMING TIPS 

Using bs as a calculator: 

8 bs 

# Distance (inches) light travels in a nanosecond. 

186000 • 5280 * 12 / le9 

11.78496 


# Compound interest (6% for 5 years on 81,000). 
int = .06 / 4 

bal = 1000 

for i = 1 5*4 bal = bal + bal*int 

bal - 1000 

346.855007 

exit 

The outline of a typical bs program: 

# initialize things: 
varl = 1 

open("read", "infile", "r") 
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NAME 

cal — print calendar 
SYNOPSIS 

cal [ month ] year 
DESCRIPTION 

Cal prints a calendar for the specified year. If a month is also specified, 
a calendar just for that month is printed. Year can be between 1 and 
9999. The month is a number between 1 and 12. The calendar produced 
is that for England and her colonies. 

Try September 1752. 

BUGS 

The year is always considered to start in January even though this is his¬ 
torically naive. 

Beware that ‘cal 78‘ refers to the early Christian era, not the 20th cen¬ 
tury. 
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NAME 

calendar — reminder service 

SYNOPSIS 

calendar [ — ] 

DESCRIPTION 

Calendar consults the file calendar in the current directory and prints 
out lines that contain today’s or tomorrow's date anywhere in the line. 
Most reasonable month-day dates such as "Dec. 7.” "december 7,” 
"12/7.” etc., are recognized, but not "7 December' or "7/12”. On week¬ 
ends "tomorrow" extends through Monday. 

When an argument is present, calendar does its job for every user who 
has a file calendar in his login directory and sends him any positive 
results by mail(l). Normally this is done daily in the wee hours under 
control of cron(8). 

FILES 

calendar 

/usr/lib/calprog to figure out today's and tomorrow’s dates 

/etc/passwd 

/tmp/cal* 

/usr/lib/crontab 

SEE ALSO 

cron(8). mail(l). 

BUGS 

Your calendar must be public information for you to get reminder ser¬ 
vice. 

Calendar's extended idea of "tomorrow" does not account for holidays. 
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NAME 

cat - concatenate and print files 
SYNOPSIS 

cat [ —u ] [ —s ] file ... 

DESCRIPTION 

Cat reads each file in sequence and writes it on the standard output. 
Thus: 

cat file 

prints the file, and: 

cat filel file2 >file3 

concatenates the first two files and places the result on the third. 

If no input file is given, or if the argument — is encountered, cof reads 
from the standard input file. Output is buffered in 512-byte blocks 
unless the —u option is specified. The —s option makes cof silent about 
non-existent files. No input file may be the same as the output file unless 
it is a special file. 

SEE ALSO 

cp(l). pr(l). 
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CB( 1) 


NAME 

cb — C program beautifier 

SYNOPSIS 

cb 

DESCRIPTION 

Cb places a copy of the C program from the standard input on the stan¬ 
dard output with spacing and indentation that displays the structure of 
the program. 
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—L Arrange for the compiler to produce code which puts the current 

linenumber into the stackframe during execution. The C- 
stacktrace of odb(l) (command Sc or SC) will then give for each 
active procedure the current linenumber. 

-g Adds entries to the symbol table of the produced .o module which 
indicate line numbers and corresponding code location. To set a 
breakpoint at line 75 you can tell adb ":b L75”. Make sure that 
only one module of a program is compiled with this option. 

—p Arrange for the compiler to produce code which counts the 

number of times each routine is called; also, if linking takes 
place, replace the standard startup routine by one which 
automatically calls montfor(3C) at the start and arranges to write 
out a mon.out file at normal termination of execution of the 
object program. An execution profile can then be generated by 
use of joro/(l). 

-T With this option initialized data is put into the text- rather than 
the data segment. Thus for programs like the shell, whose text 
segments are shared between many users, memory space can be 
saved. Apply this option only to modules with nothing but con¬ 
stant data declarations. 

-u All characters will be treated as "unsigned char”. 

—4 Changes the integer size from 2 (default) to 4. This makes pro¬ 

grams which neglect the differences between int and pointer or 
int and long much more portable. On the other hand, the pro¬ 
duced code is less efficient. When the name lcc is linked to cc, lcc 
is equivalent to cc -4. This option is also passed to the linker. The 
linker transforms the option -llib to -ILlib, e.g. -lc to -ILc or 
-lcurses to -ILcurses. These libraries are themselves compiled 
with option -4. 

-2 Like option -4. However, short parameters remain short and char 
parameters are only converted to short, not int, before they are 
pushed on the stack. This option is used for example to compile 
the system calls in the 4-byte-integer standard library 
/lib/libLc.a, which must interface to a 2-byte-integer world. 

-P Run only the macro preprocessor and place the result for each 
*.c’ file in a corresponding \i’ file that has no lines in it. 

—E Run only the macro preprocessor and send the result to the stan¬ 
dard output. The output is intended for compiler debugging; it is 
unacceptable as input to cc. 

-Dname=de/ 

-Dname 

Define the name to the preprocessor, as if by ’#define'. If no 
definition is given, the name is defined as 1. 

-Uname 

Remove any initial definition of name. 

—Idir ‘^include’ files whose names do not begin with V are always 
sought first in the directory of the file argument, then in 
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NAME 

cc. lcc - C compiler 
SYNOPSIS 

cc [ option ] ... file ... 

DESCRIPTION 

Cc is the UNIX C compiler. It accepts several types of arguments: 

Arguments whose names end with \c' are taken to be C source programs: 
they are compiled, and each object program is left on the file whose 
name is that of the source with '.o’ substituted for .c . The .o file is nor* 
mally deleted, however, if a single C program is compiled and linked all at 
one go. This C-compiler has the identifier "m68000" predefined, such 
that "#ifdef m68000” is true. 

A call "cc test.c" is the same as "cc -c test.c teSc Id /lib/crtO.o test.o -lc 
ScSc rm test.o". The call "cc •.o" is the same as "Id /lib/crtO.o *.o -lc". If 
your directory contains the file xyz.c, a call "make xyz" will result in "cc 
-o xyz xyz.c". 

The following options are interpreted by cc. See M(l) for link-time 
options. 

-c Suppress the linking phase of the compilation, and force an 
object file to be produced even if only one program is compiled. 

—o output 

Name the final output file output. If this option is used the file 
’a.out’ will be left undisturbed. This option is passed on to the 
linker. 

—f[FN] This option must be given, if the program includes floating point 
operations. The option -f alone will compile code for the Motorola 
Fast Floating Point Package, which is fast but does not have dou¬ 
ble precision arithmetic. 

The option -fF will compile code for the Motorola IEEE Floating 
Point Package, and later for the Motorola floating point coproces¬ 
sor. This package offers single and double precision according to 
the IEEE specifications. As long as the coprocessor is not avail¬ 
able. the execution speed is rather slow. 

The option -fN will compile code for the CADMUS FPP board with a 
NSC 16081 floating point processor. The numbers are also in IEEE 
format, but the generated code is much different from the one 
produced with option -fF. 

With option -f. the library libffp.a will be searched before libc.a, 
with option -fF the library libmot.a, with option -fN the library 
libnsc.a. These libraries contain also the code which was formerly 
in the mathematical library libm.a. This library has been removed. 
Option -f makes the option -DFFP implicit. Option -fF makes the 
options -D1EEE and -DMOT_IEEE implicit. Option -fN makes the 
options -D1EEE and -DNSC_IEEE implicit. 

-S Compile the named C programs, and produce an assembly listing 
on corresponding files suffixed ’.s’. This option is used mainly for 
compiler debugging. 
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directories named in —I options, then in directories on a standard 
list. 


—Qstrvng 

Find substitute compiler passes in the files named string with the 
suffixes cpp, cO, cl and c2. If string is empty, use a standard 
backup version. 

—t[p012] 

Find only the designated compiler passes in the files whose names 
are constructed by a —B option. In the absence of a —B option, 
the string is taken to be '/usr/src/cmd/c/'. 

Other arguments are taken to be either linker option arguments, or C- 
compatible object programs, typically produced by an earlier cc run, or 
perhaps libraries of C-compatible routines. These programs, together 
with the results of any compilations specified, are linked (in the order 
given) to produce an executable program with name a.out. 


FILES 

file.c 

file.o 

a.out 

/tmp/ctm* 

/lib/cpp 

/lib/c[0l2] 

/lib/oc[012] 

/lib/ocpp 

/lib/crtO.o 

/lib/lcrtO.o 

/lib/mlcrtO.o 

/lib/libc.a 

/lib/libLc.a 

/lib/libffp.a 

/lib/libmot.a 

/lib/libnsc.a 

/usr/include 


input file 

object file 

linked output 

temporaries for cc 

preprocessor 

compiler passes for cc 

backup compiler passes for cc 

backup preprocessor 

runtime initialization 

runtime initialization for option -4 

runtime initialization for profiling and option -4 

standard library, see intro (3) 

standard library for option -4 

library with fast floating point routines 

library with IEEE floating point routines for Motorola 

package 

library with IEEE floating point routines for FPP board 
with NSC 16081 

standard directory for ’^include' files 


SEE ALSO 

B. W. Kernighan and D. M. Ritchie, The C Programming Language, 

Prentice-Hall, 1978 

D. M. Ritchie, C Refer once Manual 

monitor(3C), prof(l), adb(l), ld(l). fp(3) 

DIAGNOSTICS 

The diagnostics produced by C itself are intended to be self-explanatory. 
Occasional messages may be produced by the linker. 
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NAME 

cd — change working directory 

SYNOPSIS 

cd [ directory ] 

DESCRIPTION 

If directory is not specified, the value of shell parameter SHOME is used as 
the new working directory. If directory specifies a complete path start¬ 
ing with /. directory becomes the new working directory. If neither 

case applies, cd tries to find the designated directory relative to one of 
the paths specified by the fCDPATH shell variable. SCDPATH has the same 
syntax as, and similar semantics to. the tPATH shell variable. Cd must 
have execute (search) permission in directory. 

Because a new process is created to execute each command, cd would be 
ineffective if it were written as a normal command; therefore, it is recog¬ 
nized and internal to the shell. 

SEE ALSO 

pwd(l), sh(l), chdir(2). 
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numbers. If a non-zero exit status is returned from 
the 1IR number validation program, cdc terminates and 
the delta commentary remains unchanged. 

—yfcomment] Arbitrary text used to replace the comment(s) already 
existing for the delta specified by the —r keyletter. 
The previous comments are kept and preceded by a 
comment line stating that they were changed. A null 
comment has no effect. 

]f —y is not specified and the standard input is a termi 
nal, the prompt comments? is issued on the standard 
output before the standard input is read; if the stan¬ 
dard input is not a terminal, no prompt is issued. An 
unescaped new-line character terminates the com¬ 
ment text. 

The exact permissions necessary to modify the SCCS file are docu¬ 
mented in the Source Code Control System Users Guide Simply 
stated they are either (l) if you made the delta, you can change its 
delta commentary; or (2) if you own the file and directory you can 
modify the delta commentary. 

EXAMPLES ^ _ rl 6 _ m .. bl78 . 123 45 Ibl77-54321 bl79-00001" -ytrouble s.file 

adds bl78-12345 and bl79-00001 to the UR list, removes bl77-54321 Irom 
the MR list, and adds the comment trouble to delta 1.6 of s.file. 

cdc — rl.6 s.file 

MRs? !bl77-54321 bl78-12345 bl79-00001 
comments? trouble 

does the same thing. 

WARNINGS supplied to the cdc command via the standard 

input (-on The command line), then the -m and -y lteyletters must also 
be used. 


FILES 


x-file (see detta(l)) 

z-file (see deita(l)) 


admin(l) delta(l), get(l). help(l), prs(l). sccsfile(5). , r 

So™ce Code Control System User's Guide by L. E. Bonanm and C. 

Salemi. 

DIAGNOSTICS 

Use help{ 1) for explanations. 
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NAME 

cdc — change the delta commentary of an SCCS delta 
SYNOPSIS 

cdc —rSID [—m[mrlist]] [—y[commentJ] files 
DESCRIPTION 

Cdc changes the delta commentary, for the SID specified by the —r 
keyletter, of each named SCCS file. 

Delta commentary is defined to be the Modification Request (1IR) and 
comment information normally specified via the delta( 1) command (—m 
and —y keyletters). 

If a directory is named, cdc behaves as though each file in the directory 
were specified as a named file, except that non-SCCS files (last com¬ 
ponent of the path name does not begin with s.) and unreadable files are 
silently ignored. If a name of — is given, the standard input is read (see 
WARNINGS)-, each line of the standard input is taken to be the name of an 
SCCS file to be processed. 

Arguments to cdc, which may appear in any order, consist of keyletter 
arguments, and file names. 

All the described keyletter arguments apply independently to each 
named file: 

—r SID Used to specify the SCCS identification (SID) string of 

a delta for which the delta commentary is to be 
changed. 

—m[mrlisf ] If the SCCS file has the ▼ flag set (see admin(l)) then a 
list -of MR numbers to be added and/or deleted in the 
delta commentary of the SID specified by the —r 
keyletter may be supplied. A null MR list has no effect. 

MR entries are added to the list of MRs in the same 
manner as that of delfa(l). In order to delete an MR, 
precede the MR number with the character ! (see EXAM¬ 
PLES). If the MR to be deleted is currently in the list of 
MRs, it is removed and changed into a ••comment" line. 
A list of all deleted MRs is placed in the comment sec¬ 
tion of the delta commentary and preceded by a com¬ 
ment line stating that they were deleted. 

If —m is not used and the standard input is a terminal, 
the prompt MRs? is issued on the standard output 
before the standard input is read; if the standard 
input is not a terminal, no prompt is issued. The MRs? 
prompt always precedes the comments? prompt (see 
—y keyletter). 

MRs in a list are separated by blanks and/or tab char¬ 
acters. An unescaped new-line character terminates 
the MR list. 

Note that if the ▼ flag has a value (see adTntn(l)), it is 
taken to be the name of a program (or shell pro¬ 
cedure) which validates the correctness of the MR 
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NAME 

checknews - check to see if user has news 


SYNOPSIS 

checknews [ ynqew ] [ readnews options ] 

DESCRIPTION 

checknews reports to the user whether or not he has news. 

y Reports "There is news” if the user has news to read. 

n Reports "No news” if there isn't any news to read. 

q causes checknews to be quiet. Instead of printing a message. 

the exit status indicates news. A status of 0 means no news. 1 
means there is news. 

v alters the y message to show the name of the first newsgroup 

containing unread news. Doubling ▼ (e.g. w) will cause an 
explanation of any claim of new news, and is useful if check- 
news and readnews disagree on whether there is news. 

e Executes readnews(l) if there is news. 

If there are no options, y is the default. 


FILES 


-/.newsrc Options and list of previously read articles 

/usr/lib / news / active 

Active newsgroups 


SEE ALSO 

inews(l), postnews(l), readnews(l) 
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NAME 

chfn — change full name of user 

SYNOPSIS 

chfn name string 

DESCRIPTION 

Chfn is a command similar to j>assu;d(l) except that it is used to change 
the geos field of the password file rather than the password entry. Note 
that the string specified will replace the entire gecos field of the specified 
user. If (as on the UCB system) this field contains information in addi¬ 
tion to the user's full name, this information must be included in string 
or it will be deleted. Hence chfn can be used to fix phone numbers, 
offices, etc. 

An example use of this command would be 

chfn mark 'Sc Horton,508E,7686,5240633' 

Note that the string must in general be quoted to shield blanks and spe¬ 
cial characters from the shell. The field should consist of the users 
name, followed by their office number, followed by the last 4 digits of 
their office extension and finally their home phone number. Any of these 
can be omitted. There should be no spaces in the entry except for those 
in your name. 

It is a good idea to run ftnger{l) on the user before and after chfn to 
make sure you have formatted the data correctly. 

SEE ALSO 

finger(l), passwd(5), passwd(l) 

AUTHOR 

Mark Horton 

BUGS 

The encoding of the office and extension information is installation 
dependent. 
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NAME 


chmod — change mode 


SYNOPSIS 

chmod mode file ... 

DESCRIPTION s of each named file ere changed according to mode 

which may be absolute or symbolic. An absolute mode is an octal number 
constructed from the OR of the following modes: 

4000 set user ID on execution 
2000 set group ID on execution 
1000 sticky bit, see c/imod(2) 

0400 read by owner 

0200 write by owner 

0100 execute (search in directory) by owner 

0070 read, write, execute (search) by group 

0007 read, write, execute (search) by others 

A symbolic mode has the form: 

[who] op permission [ op permission ) 

The who part is a combination of the letters u (for user's permissions), g 
(group) and o (other). The letter a stands for ugo, the default if uAo is 

omitted. 

Oo can be + to add permission to the file’s mode. - to take way permis¬ 
sion, or = to assign permission absolutely (all other bits will be reset). 

Permission is any combination of the letters r (read), w (write), x (exe 
cute), s (set owner or group ID) and t (save text - sticky); u g or o indi¬ 
cate that permission is to be taken from the current mode. Omitting 
permission is only useful with = to take away all permissions. 

Multiple symbolic modes separated by commas may be given Operations 
are performed in the order specified. The letter s is only useful with 
g and t only works with u. 

Only the owner of a file (or the super-user) may change its mode. 

EXAMPLES exa mpie denies write permission to others, the second makes a 

me execuWb” the third make? a We readable and executable by every 
body, and writable by the owner, 
chmod o—w file 


chmod +x file 
chmod 0755 file 

SEE ALSO 

ls(l). chmod(2). 
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NAME 

chown. chgrp - change owner or group 
SYNOPSIS 

chown owner file ... 
chgrp group file ... 

DESCRIPTION 

Chown changes the owner of the files to owner. The owner may be either 
a decimal user ID or a login name found in the password file. 

Chgrp changes the group ID of the files to group. The group may be 
either a decimal group ID or a group name found in the group file. 

FILES 

/etc/passwd 

/etc/group 

SEE ALSO 

chown(2), group(5), passwd(5). 
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NAME 

clear — clear terminal screen 

SYNOPSIS 

clear 

DESCRIPTION 

Clear clears your screen if this is possible. It looks in the environment 
for the terminal type and then in /etc/termcap to figure out how to clear 
the screen. 

FILES 

/etc/termcap terminal capability data base 
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NAME 

cmp — compare two files 
SYNOPSIS 

cmp [ — 1 ] [ — s ] filel file2 
DESCRIPTION 

The two files are compared. (If filel is —, the standard input is used.) 
Under default options, cmp makes no comment if the files are the same; 
if they differ, it announces the byte and line number at which the 
difference occurred. If one file is an initial subsequence of the other, 
that fact is noted. 

Options: 

—1 Print the byte number (decimal) and the differing bytes (octal) for 
each difference. 

—s Print nothing for differing files; return codes only. 

SEE ALSO 

comm(l), diff(l). 

DIAGNOSTICS 

Exit code 0 is returned for identical files. 1 for different files, and 2 for 
an inaccessible or missing argument. 
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NAME 

col — filter reverse line feeds 

SYNOPSIS 

col [—bfx] 

DESCRIPTION 

Col reads the standard input and writes the standard output. It performs 
the line overlays implied by reverse line feeds (ESC-7 in ASCII) and by 
forward and reverse half line feeds (ESC-9 and ESC-8). Col is particularly 
useful for filtering multicolumn output made with the *.rt* command of 
nroff and output resulting from use of the tbl(l) preprocessor. 

Although col accepts half line motions in its input, it normally does not 
emit them on output. Instead, text that would appear between lines is 
moved to the next lower full line boundary. This treatment can be 
suppressed by the —f (fine) option; in this case the output from col may 
contain forward half line feeds (ESC-9), but will still never contain either 
kind of reverse line motion. 

If the —b option is given, col assumes that the output device in use is not 
capable of backspacing. In this case, if several characters are to appear 
in the same place, only the last one read will be taken. 

The control characters SO (ASCII code 017), and SI (016) are assumed to 
start and end text in an alternate character set. The character set (pri¬ 
mary or alternate) associated with each printing character read is 
remembered; on output. SO and SI characters are generated where 
necessary to maintain the correct treatment of each character. 

Col normally converts white space to tabs to shorten printing time. If the 
—x option is given, this conversion is suppressed. 

All control characters are removed from the input except space, back¬ 
space, tab, return, newline. ESC (033) followed by one of 789, SI, SO, and 
VT (013). This last character is an alternate form of full reverse line 
feed, for compatibility with some other hardware conventions. All other 
non-printing characters are ignored. 

SEE ALSO 

troff(l), tbl(l). greek(l) 

BUGS 

Can’t back up more than 128 lines. 

No more than 800 characters, including backspaces, on a line. 
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NAME 

colcrt - filter nroff output for CRT previewing 
SYNOPSIS 

colcrt [ — ] [ —2 ] [ file ... ] 

DESCRIPTION 

Colcrt provides virtual half-line and reverse line feed sequences for ter¬ 
minals without such capability, and on which overstriking is destructive. 
Half-line characters and underlining (changed to dashing •—’) are placed 
on new lines in between the normal output lines. 

The optional — suppresses all underlining. It is especially useful for pre¬ 
viewing allboxed tables from f6f(l). 

The option —2 causes all half-lines to be printed, effectively double spac¬ 
ing the output. Normally, a minimal space output format is used which 
will suppress empty lines. The program never suppresses two consecu¬ 
tive empty lines, however. The -2 option is useful for sending output to 
the line printer when the output contains superscripts and subscripts 
which would otherwise be invisible. 

A typical use of colcrt would be 

tbl exum2.n | nroff —ms | colcrt — | more 

SEE ALSO 

nroff/troff(l), col(l), more(l), ul(l) 

AUTHOR 

William Joy 

BUGS 

Should fold underlines onto blanks even with the ' option so that a true 
underline character would show; if we did this, however, colcrt wouldn’t 
get rid of cu'd underlining completely. 

Can’t back up more than 102 lines. 

General overstriking is lost; as a special case *|’ overstruck with ’ or 
underline becomes '+’. 

Lines are trimmed to 132 characters. 

Some provision should be made for processing superscripts and sub¬ 
scripts in documents which are already double-spaced. 
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NAME 

colrm — remove columns from a file 
SYNOPSIS 

colrm [ started [ endcol ] ] 

DESCRIPTION 

Colrm removes selected columns from a file. Input is taken from stan¬ 
dard input. Output is sent to standard output. 

If called with one parameter the columns of each line will be removed 
starting with the specified column. If called with two parameters the 
columns from the first column to the last column will be removed. 

Column numbering starts with column 1. 

SEE ALSO 

expand(l) 

AUTHOR 

Jeff Schriebman 
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NAME 

comb — combine SCCS deltas 
SYNOPSIS 

comb [—o] [—s] [—psid] [—clist] files 
DESCRIPTION 

Comb generates a shell procedure (see sA(l)) which, when run. will 
reconstruct the given SCCS files. The reconstructed files will, hopefully, 
be smaller than the original files. The arguments may be specified in any 
order, but all keyletter arguments apply to all named SCCS files. If a 
directory is named, comb behaves as though each file in the directory 
were specified as a named file, except that non-SCCS files (last com¬ 
ponent of the path name does not begin with s.) and unreadable files are 
silently ignored. If a name of — is given, the standard input is read; each 
line of the standard input is taken to be the name of an SCCS file to be 
processed; non-SCCS files and unreadable files are silently ignored. 

The generated shell procedure is written on the standard output. 

The keyletter arguments are as follows. Each is explained as though only 
one named file is to be processed, but the effects of any keyletter argu¬ 
ment apply independently to each named file. 

—p SID The SCCS /identification string (SID) of the oldest delta to be 
preserved. All older deltas are discarded in the reconstructed 
file. 

—c list A list (see get( 1) for the syntax of a list) of deltas to be 
preserved. All other deltas are discarded. 

—o For each get —e generated, this argument causes the recon¬ 

structed file to be accessed at the release of the delta to be 
created, otherwise the reconstructed file would be accessed at 
the most recent ancestor. Use of the —o keyletter may decrease 
the size of the reconstructed SCCS file. It may also alter the 
shape of the delta tree of the original file. 

—s This argument causes comb to generate a shell procedure which, 

when run, will produce a report giving, for each file: the file name, 
size (in blocks) after combining, original size (also in blocks), and 
percentage change computed by: 

100 • (original — combined) / original 
It is recommended that before any SCCS files are actually com¬ 
bined, one should use this option to determine exactly how much 
space is saved by the combining process. 

If no keyletter arguments are specified, comb will preserve only leaf del¬ 
tas and the minimal number of ancestors needed to preserve the tree. 

FILES 

s.COMB The name of the reconstructed SCCS file, 

comb????? Temporary. 

SEE ALSO 

admin(l), delta(l), get(l), help(l), prs(l), sccsfile(5). 

Source Code Control System User’s Guide by L. E. Bonanni and C. A. 
Salemi. 
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DIAGNOSTICS 

Use help( l) for explanations. 

BUGS 

Comb may rearrange the shape of the tree of deltas. It may not save any 
space; in fact, it is possible for the reconstructed file to actually be 
larger than the original. 
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NAME 

comm — select or reject lines common to two sorted files 
SYNOPSIS 

comm [ — [ 123 ] ] filel file2 
DESCRIPTION 

Comm reads filel and file2, which should be ordered in ASCII collating 
sequence, and produces a three column output: lines only in filel; lines 
only in file2; and lines in both files. The filename ' means the standard 
input. 

• 

Flags 1, 2, or 3 suppress printing of the corresponding column. Thus 
comm —12 prints only the lines common to the two files; comm —23 prints 
only lines in the first file but not in the second; comm —123 is a no-op. 

SEE ALSO 

cmp(l), diff(l), uniq(l) 
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NAME 

compact, uncompact, ccat — compress and uncompress files, and cat 
them 

SYNOPSIS 

compact [ name ... ] , 

uncompact [ name ... ] 
ccat [ file ... ] 

DESCRIPTION 

Compact compresses the named files using an adaptive Huffman code. If 
no file names are given, then the standard input is compacted to the 
standard output. Compact operates as an on-line algorithm. Each time a 
byte is read, it is encoded immediately according to the current prefix 
code. This code is an optimal Huffman code for the set of frequencies 
seen so far. It is unnecessary to prepend a decoding tree to the 
compressed file since the encoder and the decoder start in the same 
state and stay synchronized. Furthermore, compact and uncompact can 
operate as filters. In particular, 

... | compact | uncompact |... 

operates as a (very slow) no-op. 

When an argument file is given, it is compacted and the resulting file is 
placed in file.C; file is unlinked. The first two bytes of the compacted file 
code the fact that the file is compacted. This code is used to prohibit 
recompaction. 

The amount of compression to be expected depends on the type of file 
being compressed. Typical values of compression are: Text (38%). Pascal 
Source (43%). C Source (36%) and Binary (19%). These values are the 
percentages of file bytes reduced. 

Uncompact restores the original file from a file compressed by compact. 
If no file names are given, then the standard input is uncompacted to the 
standard output. 

Ccat cats the original file from a file compressed by compact, without 
uncompressing the file. 

RESTRICTION 

The last segment of the filename must contain fewer than thirteen char¬ 
acters to allow space for the appended ’.C*. 

FILES 

*.C compacted file created by compact, removed by uncompact 

SEE ALSO 

Gallager, Robert G., "Variations on a Theme of Huffman", I.E.E.E. Tran¬ 
sactions on Information Theory, vol. IT-24, no. 6, November 1978, pp. 668 
- 674. 

AUTHOR 

Colin L. Me Master 
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NAME 

cp, In, mv — copy, link or move files 
SYNOPSIS 

cp filel [ file2 ...] target 
In filel [ file2 ...] target 
mv filel [ file2 ...] target 

DESCRIPTION 

Filel is copied (linked, moved) to target. Under no circumstance can 
filel and target be the same. If target is a directory, then one or more 
files are copied (linked, moved) to that directory. 

If mv determines that the mode of target forbids writing, it will print the 
mode (see chmod{2)) and read the standard input for one line (if the 
standard input is a terminal); if the line begins with y, the move takes 
place; if not. mv exits. 

Only mv will allow filel to be a directory, in which case the directory 
rename will occur only if the two directories have the same parent. 

SEE ALSO 

cpio(l), link(8), rm(i), chmod(2). 

BUGS 

If filel and target lie on different file systems, mv must copy the file and 
delete the original. In this case the owner name becomes that of the 
copying process and any linking relationship with other files is lost. 

Ln will not link across file systems. 
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NAME 

cpio — copy file archives in and out 

SYNOPSIS 

cpio —o [ acBSv ] 

cpio —i [ BScdmrtuvfshb6 ] [ patterns ] 
cpio —p [ adlmruv ] directory 
DESCRIPTION 

Cpio —o (copy out) reads the standard input to obtain a list of path 
names and copies those files onto the standard output together with 
path name and status information. 

Cpio —i (copy in) extracts files from the standard input which is assumed 
to be the product of a previous cpio —o. Only files with names that match 
patterns are selected. Patterns are given in the name-generating nota¬ 
tion of sh{l). In patterns, meta-characters ?, •. and [...] match the slash 
/ character. Multiple patterns may be specified and if no patterns are 
specified, the default for patterns is • (i.e., select all files). The extracted 
files are conditionally created and copied into the current directory tree 
based upon the options described below. 

Cpio —p (pass) reads the standard input to obtain a list of path names of 
files that are conditionally created and copied into the destination direc¬ 
tory tree based upon the options described below. 

The meanings of the available options are: 

a Reset access times of input files after they have been copied. 

B Input/output is to be blocked 5,120 bytes to the record (does not 
apply to the pass option; meaningful only with data directed to or 
from /dev/rmt?). 

S Input/output is to be blocked 61,440 bytes to the record (does not 
apply to the pass option; meaningful for streaming tapes, e.g. 
/dev/rstO). 

d Directories are to be created as needed. 

c Write header information in ASCII character form for portability, 
r Interactively rename files. If the user types a null line, the file is 
skipped. 

t Print a table of contents of the input. No files are created, 

u Copy unconditionally (normally, an older file will not replace a 

newer file with the same name). 

v Verbose: causes a list of file names to be printed. When used with 
the t option, the table of contents looks like the output of an Is —1 
command (see ls(l)). 

1 Whenever possible, link files rather than copying them. Usable 

only with the —p option. 

m Retain previous file modification time. This option is ineffective on 
directories that are being copied, 
f Copy in all files except those in patterns, 

s Swap bytes. Use only with the —i option, 

h Swap halfwords. Use only with the —i option, 

b Swap both bytes and halfwords. Use only with the —i option. 

6 Process an old (i.e., UNIX. System Sixth Edition format) file. Only 
useful with —i (copy in). 
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E XAM p LES example below eopies the contents of a directory into an 

archive; the second duplicates a directory hierarchy: 

Is | cpio —o >/dev/mtO 
cd olddir 

find . -depth -print | cpio -pdl newdir 
The trivial case -find . -depth -print | cpio -oB >/dev/rmtO" can be 
handled more efficiently by: 

find . -cpio /dev/rmtO 

SEE ALSO , v 

ar(l). find(l). cpio(5). 


BUGS 


Path names are restricted to 128 characters^ If there are loo many 
uniaue linked files, the program runs out of memory to keep tracK oi 
them and, thereafter, linking information is lost. Only the super-user 

can copy special files. 
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NAME 

cpp — the C language preprocessor 
SYNOPSIS 

/lib/cpp [ option ... ] [ ifile [ ofile ] ] 

DESCRIPTION 

Cpp is the C language preprocessor which is invoked as the first pass of 
any C compilation using the cc(l) compnand. Thus the output of cpp is 
designed to be in a form acceptable as input to the next pass of the C 
compiler. As the C language evolves, cpp and the rest of the C compila¬ 
tion package will be modified to follow these changes. Therefore, the use 
of cpp other than in this framework is not suggested. The preferred way 
to invoke cpp is through the cc(l) command since the functionality of 
cpp may someday be moved elsewhere. See m4(l) for a general macro 
processor. 

Cpp optionally accepts two file names as arguments. Ifile and ofile are 
respectively the input and output for the preprocessor. They default to 
standard input and standard output if not supplied. 

The following options to cpp are recognized: 

—P Preprocess the input without producing the line control informa¬ 

tion used by the next pass of the C compiler. 

—C By default, cpp strips C-style comments. If the —C option is 

specified, all comments (except those found on cpp directive lines) 
are passed along. 

—U name 

Remove any initial definition of name, where name is a reserved 
symbol that is predefined by the particular preprocessor. The 
current list of these possibly reserved symbols includes: 
operating system: ibm, geos, os, tss, unix 
hardware: interdata, pdpll, u370, u3b, vax 

UNIX System variant: 

RES. RT 

—Dname 

—Dname=def 

Define name as if by a f define directive. If no -def is given, name 
is defined as 1. 

—Idir Change the algorithm for searching for finclude files whose names 
do not begin with / to look in dir before looking in the directories 
on the standard list. Thus, finclude files whose names are 
enclosed in "" will be searched for first in the directory of the ifile 
argument, then in directories named in —I options, and last in 
directories on a standard list. For finclude files whose names are 
enclosed in <>. the directory of the ifile argument is not 
searched. 

Two special names are understood by cpp. The name ___LINE__ is 
defined as the current line number (as a decimal integer) as known by 

cpp. and_FILE__ is defined as the current file name (as a C string) as 

known by cpp. They can be used anywhere (including in macros) just as 
any other defined name. 
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All cpp directives start with lines begun by #. The directives are: 
u define name token-string 

Replace subsequent instances of name with token-string. 

#define name( arg . arg ) token-string 

Notice that there can be no space between name and the 
Replace subsequent instances of name followed by a (. a list of 
comma separated tokens, and a ) by token-string where each 
occurrence of an arg in the token-string is replaced by the 
corresponding token in the comma separated list. 

Inndef 71(17716 

Cause the definition of name (if any) to be forgotten from now on. 


# include "filename" 

# include <filename> . ..... . 

Include at this point the contents of filename (which will then be 
run through cpp). When the <fllename> notation is used 
filename is only searched for in the standard places. See the I 
option above for more detail. 


#line integer-constant "filename" 

Causes cpp to generate line control information for the next pass 
of the C compiler. Integer-constant is the line number of the next 
line and filename is the file where it comes from. If "filename" is 
not given, the current file name is unchanged. 


#Cndif Ends a section of lines begun by a test directive (#if. #ifdef. or 
fifndef). Each test directive must have a matching fendif. 

#ifdef name 

The lines following will appear in the output if and only if name 
has been the subject of a previous fdefine without being the sub¬ 
ject of an intervening #undef. 

#ifndef name .... . , ., 

The lines following will not appear in the output if and only if 
name has been the subject of a previous fdefine without being the 
subject of an intervening #undef. 

#if constant-expression 

Lines following will appear in the output if and only if the 
constant-expression evaluates to non-zero. All binary non¬ 
assignment C operators, the ?: operator, the unary -. !. and ~ 
operators are all legal in constant-expression. The precedence of 
the operators is the same as defined by the C language. There is 
also a unary operator defined, which can be used in constant- 
expression in these two forms: defined ( name ) or defined name. 
This allows the utility of fifdef and fifndef in a #if directive. Only 
these operators, integer constants, and names which are known by 
cpp should be used in constant-expression. In particular, the 
sizeof operator is not available. 

I else Reverses the notion of the test directive which matches this direc¬ 
tive. So if lines previous to this directive are ignored, the following 
lines will appear in the output. And vice versa. 
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The test directives and the possible felse directives can be nested. 

FILES 

/usr/include standard directory for ^include files 
SEE ALSO 

cc(l), m4(l). 

DIAGNOSTICS 

The error messages produced by cpp are intended to be self-explanatory. 
The line number and filename where the error occurred are printed 
along with the diagnostic. 

NOTES 

When newline characters were found in argument lists for macros to be 
expanded, previous versions of cpp put out the newlines as they were 
found and expanded. The current version of cpp replaces these newlines 
with blanks to alleviate problems that the previous versions had when 
this occurred. 
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NAME 

create — create a file 

SYNOPSIS 

create file... 

DESCRIPTION 

Create creates one or more files named file... with a length of 0 bytes. 
This is written as a shell procedure and should really give you a laugh 
when you read it. 
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NAME 

cref — make cross-reference listing 
SYNOPSIS 

cref [ — aci!nostuxl23 ] files 
DESCRIPTION 

Cref makes a cross-reference listing of assembler or C programs; files 
are searched for symbols in the appropriate syntax. 

The output report is in four columns: 

1. symbol; 

2. file name; 

3. see below; 

4. text as it appears in the file. 

Cref uses either an ignore file or an only file. If the —i option is given, 
the next argument is taken to be an ignore file; if the —o option is given, 
the next argument is taken to be an only file. Ignore and only files are 
lists of symbols separated by new-lines. All symbols in an ignore file are 
ignored in columns 1 and 3 of the output. If an only file is given, only 
symbols in that file will appear in column 1. Only one of these options 
may be given; the default setting is —i using the default ignore file (see 
FILES below). Assembler pre-defined symbols or C keywords are ignored. 

The —s option causes current symbols to be put in column 3. In the 
assembler, the current symbol is the most recent name symbol; in C, the 
current function name. The —1 option causes the line number within the 
file to be put in column 3. 

The —t option causes the next available argument to be used as the name 
of the intermediate file (instead of the temporary file /tmp/crt??). This 
file is created and is not removed at the end of the process. 

The cref options are: 

a assembler format (default) 
c C format input 
i use an ignore file (see above) 

1 put line number in column 3 (instead of current symbol) 
n omit column 4 (no context) 
o use an only file (see above) 
s current symbol in column 3 (default) 
t user-supplied temporary file 
u print only symbols that occur exactly once 
x print only C external symbols 

1 sort output on column 1 (default) 

2 sort output on column 2 

3 sort output on column 3. 

FILES 

/tmp/crt?? temporaries 
/usr/lib/cref/aign 

default assembler ignore file 
/usr/lib/cref/atab 

grammar table for assembler files 
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/usr/lib/cref/cign 

default C ignore file 
/usr/lib/cref/ctab 

grammar table for C files 
/usr/lib/cref/crpost 

post-processor 
/usr/lib/cref/upost 

post-processor for — u option 

SEE ALSO 

as(l), cc(l), sort(l), xref(l). 

BUGS 

Cref inserts an ASCII DEL character into the intermediate file after the 
eighth character of each name that is eight or more characters long in 
the source file. 
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NAME 

crypt — encode/decode 

SYNOPSIS 

crypt [ password ] 

DESCRIPTION 

Crypt reads from the standard input and writes on the standard output. 
The password is a key that selects a particular transformation. If no 
password is given, crypt demands a key from the terminal and turns off 
printing while the key is being typed in. Crypt encrypts and decrypts 
with the same key: 

crypt key <clear >cypher 
crypt key Ccypher | pr 

will print the clear. 

Files encrypted by crypt are compatible with those treated by the editor 
ed in encryption mode. 

The security of encrypted files depends on three factors: the fundamen¬ 
tal method must be hard to solve; direct search of the key space must be 
infeasible; ‘sneak paths’ by which keys or cleartext can become visible 
must be minimized. 

Crypt implements a one-rotor machine designed along the lines of the 
German Enigma, but with a 256-element rotor. Methods of attack on 
such machines are known, but not widely; moreover the amount of work 
required is likely to be large. 

The transformation of a key into the internal settings of the machine is 
deliberately designed to be expensive, i.e. to take a substantial fraction 
of a second to compute. However, if keys are restricted to (say) three 
lower-case letters, then encrypted files can be read by expending only a 
substantial fraction of five minutes of machine time. 

Since the key is an argument to the crypt command, it is potentially visi¬ 
ble to users executing ps(l) or a derivative. To minimize this possibility, 
crypt takes care to destroy any record of the key immediately upon 
entry. No doubt the choice of keys and key security are the most vulner¬ 
able aspect of crypt. 

FILES 

/dev/tty for typed key 

SEE ALSO 

ed(l), makekey(8) 

BUGS 

There is no warranty of merchantability nor any warranty of fitness for a 
particular purpose nor any other warranty, either express or implied, as 
to the accuracy of the enclosed materials or as to their suitability for 
any particular purpose. Accordingly, Bell Telephone Laboratories 
assumes no responsibility for their use by the recipient. Further, Bell 
Laboratories assumes no obligation to furnish any assistance of any kind 
whatsoever, or to furnish any additional information or documentation. 
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NAME 

csh - a shell (command interpreter) with C-like syntax 
SYNOPSIS 

csh [ —cefinstvVxX ] [ arg ... ] 

DESCRIPTION 

Csh is a first implementation of a command language interpreter incor¬ 
porating a history mechanism (see History Substitutions) and a C-like 
syntax. 

An instance of csh begins by executing commands from the file \cshrc’ in 
the home directory of the invoker. If this is a login shell then it also exe¬ 
cutes commands from the file '.login' there. It is typical for users on 
crt's to put the command "stty crt" in their .login file, and to also invoke 
fabs(l) there. 

In the normal case, the shell will then begin reading commands from the 
terminal, prompting with ’% '. Processing of arguments and the use of 
the shell to process files containing command scripts will be described 
later. 

The shell then repeatedly performs the following actions: a line of com¬ 
mand input is read and broken into words. This sequence of words is 
placed on the command history list and then parsed. Finally each com¬ 
mand in the current line is executed. 

When a login shell terminates it executes commands from the file 
'.logout' in the users home directory. 

Lexical structure 

The shell splits input lines into words at blanks and tabs with the follow¬ 
ing exceptions. The characters *|' '<’ *>* '(' ')’ form separate words. 
If doubled in '| |\ '«' or '»' these pairs form single words. These 

parser metacharacters may be made part of other words, or prevented 
their special meaning, by preceding them with 'V. A newline preceded by 
a '\ ’ is equivalent to a blank. 

In addition strings enclosed in matched pairs of quotations, or , 

form parts of a word; metacharacters in these strings, including blanks 
and tabs, do not form separate words. These quotations have semantics 
to be described subsequently. Within pairs of or "" characters a new- 
line preceded by a 'V gives a true newline character. 

When the shell's input is not a terminal, the character introduces a 
comment which continues to the end of the input line. It is prevented 
this special meaning when preceded by ‘\ ’ and in quotations using . 
and *'". 

Commands 

A simple command is a sequence of words, the first of which specifies the 
command to be executed. A simple command or a sequence of simple 
commands separated by "|’ characters forms a pipeline. The output of 
each command in a pipeline is connected to the input of the next. 
Sequences of pipelines may be separated by and are then executed 
sequentially. A sequence of pipelines may be executed without immedi¬ 
ately waiting for it to terminate by following it with an '&'. 
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Any of the above may be placed in *(’ *)’ to form a simple command (which 
may be a component of a pipeline, etc.) It is also possible to separate 
pipelines with *| |‘ or 'ScSc' indicating, as in the C language, that the second 
is to be executed only if the first fails or succeeds respectively. (See 
Expressions.) 

Jobs 

The shell associates a job with each pipeline. It keeps a table of current 
jobs, printed by the jobs command, and assigns them small integer 
numbers. When a job is started asynchronously with 'Sc', the shell prints 
a line which looks like: 

[1] 1234 

indicating that the jobs which was started asynchronously was job 
number 1 and had one (top-level) process, whose process id was 1234. 

A job being run in the background will stop if it tries to read from the 
terminal. Background jobs are normally allowed to produce output, but 
this can be disabled by giving the command “stty tostop’*. If you set this 
tty option, then background jobs will stop when they try to produce out¬ 
put like they do when they try to read input. 

The shell maintains a notion of the current and previous jobs. In output 
pertaining to jobs, the current job is marked with a and the previous 
job with a The abbreviation ‘%+’ refers to the current job and *%-' 
refers to the previous job. For close analogy with the syntax of the his¬ 
tory mechanism (described below), *%%' is also a synonym for the current 
job. 

Status reporting 

This shell learns immediately whenever a process changes state. It nor¬ 
mally informs you whenever a job becomes blocked so that no further 
progress is possible, but only just before it prints a prompt. This is done 
so that it does not otherwise disturb your work. If, however, you set the 
shell variable notify, the shell will notify you immediately of changes of 
status in background jobs. There is also a shell command notify which 
marks a single process so that its status changes will be immediately 
reported. By default notify marks the current process; simply say 
‘notify’ after starting a background job to mark it. 

Substitutions 

We now describe the various transformations the shell performs on the 
input in the order in which they occur. 

History substitutions 

History substitutions place words from previous command input as por¬ 
tions of new commands, making it easy to repeat commands, repeat 
arguments of a previous command in the current command, or fix spel¬ 
ling mistakes in the previous command with little typing and a high 
degree of confidence. History substitutions begin with the character *!* 
and may begin anywhere in the input stream (with the provison that they 
do not nest.) This '!’ may be preceded by an V to prevent its special 
meaning; for convenience, a T is passed unchanged when it is followed by 
a blank, tab. newline, ‘=‘ or ‘(’. (History substitutions also occur when an 
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input line begins with *t’. This special abbreviation will be described 
later.) Any input line which contains history substitution is echoed on 
the terminal before it is executed as it could have been typed without 
history substitution. 

Commands input from the terminal which consist of one or more words 
are saved on the history list. The history substitutions reintroduce 
sequences of words from these saved commands into the input stream. 
The size of which is controlled by the history variable; the previous com¬ 
mand is always retained, regardless of its value. Commands are num¬ 
bered sequentially from 1. 

For definiteness, consider the following output from the history com¬ 
mand: 

9 write michael 

10 ex write.c 

11 cat oldwrite.c 

12 difT *write.c 

The commands are shown with their event numbers. It is not usually 
necessary to use event numbers, but the current event number can be 
made part of the prompt by placing an *!’ in the prompt string. 

With the current event 13 we can refer to previous events by event 
number '111', relatively as in ‘I—2' (referring to the same event), by a 
prefix of a command word as in *!d' for event 12 or 'Iwri' for event 9, or by 
a string contained in a word in the command as in '!?mic?' also referring 
to event 9. These forms, without further modification, simply reintro¬ 
duce the words of the specified events, each separated by a single blank. 
As a special case '!!’ refers to the previous command; thus *!!* alone is 
essentially a redo. 

To select words from an event we can follow the event specification by a 
and a designator for the desired words. The words of a input line are 
numbered from 0, the first (usually command) word being 0, the second 
word (first argument) being 1, etc. The basic word designators are: 

0 first (command) word 

n n 'th argument 

t first argument, i.e. T 

8 last argument 

% word matched by (immediately preceding) ?s ? search 
x—y range of words 

—y abbreviates '0—y’ 

* abbreviates ‘t—S’, or nothing if only 1 word in event 

x* abbreviates 'x— S' 

x— like '*•’ but omitting word '$’ 

The ':' separating the event specification from the word designator can 
be omitted if the argument selector begins with a ’t’, ‘S’, ’ or 

After the optional word designator can be placed a sequence of modifiers, 
each preceded by a The following modifiers are defined: 

h Remove a trailing pathname component, leaving the head, 

r Remove a trailing '.xxx' component, leaving the root name, 

e Remove all but the extension ‘.xxx’ part. 
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s/l /r / Substitute l for r 


t 

& 

g 

P 

q 

X 


iUDSUiuvc lui ' * 1 • *u 

Remove all leading pathname components, leaving the tail. 
Repeat the previous substitution. 

Apply the change globally, prefixing the above, e.g. g& . 

Print the new command but do not execute it. 

Quote the substituted words, preventing further substitutions. 
Like q. but break into words at blanks, tabs and newlines. 

Unless preceded by a *g*- the modification is applied only to the first 
modifiable word. With substitutions, it is an error for no word to be appli¬ 
cable. 

The left hand side of substitutions are not regular expressions in the 
of the editors, but rather strings. Any character may be used as 
the delimiter in place of V; a 'V quotes the delimiter into the 1 and 
strings The character •&' in the right hand side is replaced by the text 
from the left. A V quotes A also A null l usesth. uS 

either from a l or from a contextual scan string s in . • The . tr ®“ "j 6 
delimiter in the substitution may be omitted if a newline follows immedi¬ 
ately as may the trailing '?’ in a contextual scan. 

A historv reference may be given without an event specification, e.g. •'.S’. 
In this case the reference is to the previous command unless a previous 
history reference occurred on the same line in which case this form 
repeats the previous reference. Thus *!?foo?t !S* gives the first and last 
arguments from the command matching ?foo. . 

A special abbreviation of a history reference occurs »hent h efirstnon- 
blank character of an input line is a *t\ This is equivalent to !.st provid 
ing a convenient shorthand for substitutions on the text of the P r ^°“ s 
Hne. Thus tlbtlib- Axes the spelling of 'lib' ‘".^e prerious commend. 
Finally a history substitution may be surrounded with { and j if neces 
sarv to insulate it from the characters which follow. Thus, after Is Id 
!!p7ul' we Sght do !iUa- to do Is -Id -paula’. while Mia* would look for a 

command starting Ta’. 

Quotations with ' and " 

The quotation of strings by *'■ and can be used to prevent all or some 
of the remaining substitutions. Strings enclosed m arePr? venl |? 
further interpretation. Strings enclosed in - are yet variable and com 
mand expanded as described below. 

In both cases the resulting text becomes (all or part of) a single word; 
onlv in one special case (see Command Substxtitxon below) does 
quoted string yield parts of more than one word; - quoted strings never 

do. 

Alias substitution 

The shell maintains a list of aliases which can be established, displayed 
modified by the alias end unalias commends , After . commend hne 
is scanned, it is parsed into distinct commands and the first word of each 

command, left-to-right, is checked to see if it has ‘ *iT wit £ [he h!s- 
then the text which is the alias for that command is reread with the h,s 
tory mechanism available as though that command were the previous 
input line. The resulting words replace the command and argumen 
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If no reference is made to the history list, then the argument list is left 
unchanged. 

Thus if the alias for ‘Is’ is ‘Is —1’ the command ‘Is /usr‘ would map to *ls —1 
/usr’, the argument list here being undisturbed. Similarly if the alias for 
‘lookup 1 was ‘grep !t /etc/passwd’ then ‘lookup bill’ would map to ‘ereD 
bill /etc/passwd’. v 

If an alias is found, the word transformation of the input text is per¬ 
formed and the aliasing process begins again on the reformed input line 
Looping is prevented if the first word of the new text is the same as the 
old by flagging it to prevent further aliasing. Other loops are detected 
and cause an error. 

Note that the mechanism allows aliases to introduce parser metasyntax. 
Thus we can ‘alias print 'pr V* | lpr'’ to make a command which pr’s its 
arguments to the line printer. 

Variable substitution 

The shell maintains a set of variables, each of which has as value a list of 
zero or more words. Some of these variables are set by the shell or 
referred to by it. For instance, the argv variable is an image of the 
shell s argument list, and words of this variable's value are referred to in 
special ways. 

The values of variables may be displayed and changed by using the set 
and unset commands. Of the variables referred to by the shell a number 
are toggles; the shell does not care what their value is, only whether they 
are set or not. For instance, the verbose variable is a toggle which causes 
command input to be echoed. The setting df this variable results from 
the —v command line option. 

Other operations treat variables numerically. The command permits 
numeric calculations to be performed and the result assigned to a vari¬ 
able. Variable values are. however, always represented as (zero or more) 
strings. For the purposes of numeric operations, the null string is con¬ 
sidered to be zero, and the second and subsequent words of multiword 
values are ignored. 

After the input line is aliased and parsed, and before each command is 
executed, variable substitution is performed keyed by ’8’ characters. 
This expansion can be prevented by preceding the ‘8’ with a ‘\ * except 
within ‘‘"s where it always occurs, and within ‘"s where it never occurs. 
Strings quoted by *'* are interpreted later (see Command substitution 
below) so 'S’ substitution does not occur there until later, if at all. A 'S’ 
is passed unchanged if followed by a blank, tab, or end-of-line. 

Input/output redirections are recognized before variable expansion, and 
are variable expanded separately. Otherwise, the command name and 
entire argument list are expanded together. It is thus possible for the 
first (command) word to this point to generate more than one word, the 
first of which becomes the command name, and the rest of which become 
arguments. 

Unless enclosed in or given the ’:q’ modifier the results of variable sub¬ 
stitution may eventually be command and filename substituted. Within 
a variable whose value consists of multiple words expands to a 
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(portion of) a single word, with the words of the variables value separated 
by blanks. When the ':q' modifier is applied to a substitution the variable 
will expand to multiple words with each word separated by a blank and 
quoted to prevent later command or filename substitution. 

The following metasequences are provided for introducing variable values 
into the shell input. Except as noted, it is an error to reference a vari¬ 
able which is not set. 

Sname 

Sfnamej 

Are replaced by the words of the value of variable name, each 
separated by a blank. Braces insulate name from following charac¬ 
ters which would otherwise be part of it. Shell variables have names 
consisting of up to 20 letters and digits starting with a letter. The 
underscore character is considered a letter. 

If name is not a shell variable, but is set in the environment, then 
that value is returned (but : modifiers and the other forms given 
below are not available in this case). 

$name[selector] 

S|name[selector]j 

May be used to select only some of the words from the value of 
name. The selector is subjected to *8’ substitution and may consist 
of a single number or two numbers separated by a The first word 
of a variables value is numbered 'l*. If the first number of a range is 
omitted it defaults to V. If the last member of a range is omitted it 
defaults to ‘S#name\ The selector selects all words. It is not an 
error for a range to be empty if the second argument is omitted or 
in range. 

Sfname 

S[)jfnamej 

Gives the number of words in the variable. This is useful for later 
use in a '[selector]’. 

SO 

Substitutes the name of the file from which command input is being 
read. An error occurs if the name is not known. 

Snumber 

Sjnumberj 

Equivalent to 'Bargv[number]\ 

S* 

Equivalent to ’8argv[*]’. 

The modifiers *:h’, ':t'. *:r\ *:q' and ':x' may be applied to the substitutions 
above as may ':gh', ':gt' and *:gr'. If braces '(’ *[' appear in the command 
form then the modifiers must appear within the braces. The current 
implementation allows only one *:* modifier on each * 8 * expansion. 

The following substitutions may not be modified with modifiers. 

S?name 

S|?namej 

Substitutes the string T if name is set. 'O' if it is not. 
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8?0 


8S 


S< 


Substitutes T if the current input filename is known, ’O' if it is not. 

Substitute the (decimal) process number of the (parent) shell. 

Substitutes a line from the standard input, with no further interpre- 

shellscHp e t reafter K bC USCd l ° rCad fr ° m the keyboard! a 

Command and filename substitution 

r * mainin S substitutions, command and filename substitution, are 
pphed selectively to the arguments of builtin commands. This means 
that portions of expressions which are not evaluated are not subjecTed to 
these expansions. For commands which are not internal to the shell the 
command name is substituted separately from the argument list. This 

:M,d r o S f V th r e y m a am'she,r > npUt -° Ut > ut * Permed, and in a 

Command substitution 

Command substitution is indicated by a command enclosed in •" The 
output from such a command is normally broken into separate words at 
blanks, tabs and newlines, with null words being discarded, this text then 
replacing the original string. Within ""s. only newlines force new words 
blanks and tabs are preserved. 

In any case, the single final newline does not force a new word. Note that 
it is thus possible for a command substitution to yield only part of a 
word, even if the command outputs a complete line. 

Filename substitution 

char W a°r^r C °^ a i^ S ^1°! the characters *•’. *?*. V °r T or begins with the 
character . then that word is a candidate for filename substitution 
also known as ’globbing’. This word is then regarded as a pattern and 
rep aced with an alphabetically sorted list of file names which match the 
pattern. In a list of words specifying filename substitution it is an error 
for no pattern to match an existing file name, but it is not required for 
each pattern to match. Only the metacharacters *?* and *[* imply pat¬ 
tern matching, the characters and *(• being more akin to abbrevia- 
tions. 

In matching filenames, the character V at the beginning of a filename or 
immediately following a V. as well as the character V must be matched 
explicitly. The character *•* matches any string of characters, including 
he null string. The character *?’ matches any single character. The 
sequence matches any one of the characters enclosed Within ‘f V 

betwe r enth C e h two CterS Separated by matches any character lexically 

The character at the beginning of a filename is used to refer to home 
directories. Standing alone, i.e. it expands to the invokers home 
directory as reflected in the value of the variable home. When followed by 
a name consisting of letters, digits and characters the shell searches 
for a user with that name and substitutes their home directory; thus 
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•-ken' might expand to Vusr/ken’ and ’-ken/chmach’ to 
Vusr /ken/chmach’. If the character ’-’ is followed by a character other 
than a letter or ’/’ or appears not at the beginning of a word, it is left 
undisturbed. 

The metanotation ’ajb.c.dje’ is a shorthand for *abe ace ade\ Left to 
right order is preserved, with results of matches being sorted separately 
at a low level to preserve this order. This construct may be nested. Thus 
'-source/sl/{oldls.lsj.c’ expands to Vusr/source/sl/oldls.c 
/usr/source/si/ Is.c’ whether or not these files exist without any chance 
of error if the home directory for ’source* is ’/usr/source’. Similarly 
•.y|memo,*boxj' might expand to ’../memo ../box ../mbox'. (Note that 
•memo’ was not sorted with the results of matching ’•box’.) As a special 
case ■{'. ’{’ and •({’ are passed undisturbed. 

Input/output 

The standard input and standard output of a command may be 
redirected with the following syntax: 

< name 

Open file name (which is first variable, command and filename 
expanded) as the standard input. 

<< word 

Read the shell input up to a line which is identical to word. Word is 
not subjected to variable, filename or command substitution, and 
each input line is compared to word before any substitutions are 
done on this input line. Unless a quoting ’V. *" or '’ appears in 

word variable and command substitution is performed on the inter - 
vening lines, allowing ’V to quote ’S', *V and Commands which 
are substituted have all blanksj tabs, and newlines preserved, except 
for the final newline which is dropped. The resultant text is placed 
in an anonymous temporary file which is given to the command as 
standard input. 

> name 
>! name 
>& name 
>&! name 

The file name is used as standard output. If the file does not exist 
then it is created; if the file exists, its is truncated, its previous con¬ 
tents being lost. 

If the variable noclobber is set, then the file must not exist or be a 
character special file (e.g. a terminal or ’/dev/null’) or an error 
results. This helps prevent accidental destruction of files. In this 
case the forms can be used and suppress this check. 

The forms involving ’&’ route the diagnostic output into the specified 
file as well as the standard output. Name is expanded in the same 
way as ’<’ input filenames are. 

» name 
>>& name 
>>! name 
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»&! name 

Uses file name as standard output like '>' but places output at the 
end of the file. If the variable noclobber is set, then it is an error for 
the file not to exist unless one of the T forms is given. Otherwise 
similar to 

A command receives the environment in which the shell was invoked as 
modified by the input-output parameters and the presence of the com¬ 
mand in a pipeline. Thus, unlike some previous shells, commands run 
from a file of shell commands have no access to the text of the com¬ 
mands by default; rather they receive the original standard input of the 
shell. The '<<' mechanism should be used to present inline data. This 
permits shell command scripts to function as components of pipelines 
and allows the shell to block read its input. Note that the default stan¬ 
dard input for a command run detached is not modified to be the empty 
file ‘/dev/null’; rather the standard input remains as the original stan¬ 
dard input of the shell. If this is a terminal and if the process attempts 
to read from the terminal, then the process will block and the user will 
be notified (see Jobs above.) 

Diagnostic output may be directed through a pipe with the standard out¬ 
put. Simply use the form '|&' rather than just *|*. 

Expressions 

A number of the builtin commands (to be described subsequently) take 
expressions, in which the operators are similar to those of C, with the 
same precedence. These expressions appear in the @, exit, if, and while 
commands. The following operators are available: 

| | && | T & ==!= =~ !~ <=>=<>«»+-•/% t ~ 

( ) 

Here the precedence increases to the right, '==’ '!=' •=~' and '<=' 
'>=' '<’ and "<<’ and ‘>>’, '+’ and '/’ and ‘7» being, in groups, at 

the same level. The '==’ \'=' '»•'•’ and *!~' operators compare their argu¬ 
ments as strings; all others operate on numbers. The operators *=*-’ and 
*!*'*’ are like '!=' and '==' except that the right hand side is a pattern 
(containing, e g. ‘‘’s. '?'s and instances of *[...)*) against which the left 
hand operand is matched. This reduces the need for use of the switch 
statement in shell scripts when all that is really needed is pattern match¬ 
ing. 

Strings which begin with 'O’ are considered octal numbers. Null or miss¬ 
ing arguments are considered 'O'. The result of all expressions are 
strings, which represent decimal numbers. It is important to note that 
no two components of an expression can appear in the same word; 
except when adjacent to components of expressions which are syntacti¬ 
cally significant to the parser ('&' *|* '<’ '>' '(’ ')') they should be sur¬ 
rounded by spaces. 

Also available in expressions as primitive operands are command execu¬ 
tions enclosed in *{' and '{' and file enquiries of the form ’—l name' where 
l is one of: 

r read access 

w write access 
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x execute access 
e existence 

o ownership 

z zero size 

f plain file 

d directory 

The specified name is command and filename expanded and then tested 
to see if it has the specified relationship to the real user. If the file does 
not exist or is inaccessible then all enquiries return false, i.e. 'O'. Com¬ 
mand executions succeed, returning true. i.e. *1', if the command exits 
with status 0. otherwise they fail, returning false, i.e. 'O'. If more detailed 
status information is required then the command should be executed 
outside of an expression and the variable status examined. 

Control flow 

The shell contains a number of commands which can be used to regulate 
the flow of control in command files (shell scripts) and (in limited but 
useful ways) from terminal input. These commands all operate by forc¬ 
ing the shell to reread or skip in its input and. due to the implementa¬ 
tion. restrict the placement of some of the commands. 

The foreach, switch, and while statements, as well as the if—then—else 
form of the if statement require that the major keywords appear in a 
single simple command on an input line as shown below. 

If the shell's input is not seekable, the shell buffers up input whenever a 
loop is being read and performs seeks in this internal buffer to accom¬ 
plish the rereading implied by the loop. (To the extent that this allows, 
backward goto's will succeed on non-seekable inputs.) 

Builtin commands 

Builtin commands are executed within the shell. If a builtin command 
occurs as any component of a pipeline except the last then it is executed 
in a subshell. 

alias 

alias name 

alias name wordlist 

The first form prints all aliases. The second form prints the alias for 
name. The final form assigns the specified wordlist as the alias of 
name; wordlist is command and filename substituted. Name is not 
allowed to be alias or unalias. 

break 

Causes execution to resume after the end of the nearest enclosing 
foreach or while. The remaining commands on the current line are 
executed. Multi-level breaks are thus possible by writing them all on 
one line, 
breaksw 

Causes a break from a switch, resuming after the endsw. 
case label: 

A label in a switch statement as discussed below. 
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cd 

cd name 
chdir 

chdir name 

Change the shells working directory to directory name. If no argu¬ 
ment is given then change to the home directory of the user. 

If name is not found as a subdirectory of the current directory (and 
does not begin with V, *./• or *../•). then each component of the 
variable cdpath is checked to see if it has a subdirectory name 
Finally, if all else fails but name is a shell variable whose value 
begins with / , then this is tried to see if it is a directory, 
continue 

Continue execution of the nearest enclosing while or foreach. The 
rest of the commands on the current line are executed, 
default: 

Labels the default case in a switch statement. The default should 
come after all case labels. 

dirs 

Prints the directory stack; the top of the stack is at the left, the 
first directory in the stack being the current directory. 

echo wordlist 
echo —n wordlist 

The specified words are written to the shells standard output, 
separated by spaces, and terminated with a newline unless the -ri 
option is specified. 

else 

end 

endif 

endsw 

See the description of the foreach, if, switch, and while statements 
below. 

eval arg ... 

(As in sA(l).) The arguments are read as input to the shell and the 
resulting command(s) executed. This is usually used to execute 
commands generated as the result of command or variable substitu¬ 
tion. since parsing occurs before these substitutions. See fsef(l) for 
an example of using eval. 

exec command 

The specified command is executed in place of the current shell. 

exit 

exit(expr) 

The shell exits either with the value of the status variable (first 
form) or with the value of the specified expr (second form). 

foreach name (wordlist) 
end 

The variable name is successively set to each member of wordlist 
and the sequence of commands between this command and the 
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matching end are executed. (Both foreach and end must appear 
alone on separate lines.) 

The builtin command continue may be used to continue the loop 
prematurely and the builtin command break to terminate it prema¬ 
turely. When this command is read from the terminal, the loop is 
read up once prompting with ’?’ before any statements in the loop 
are executed. If you make a mistake typing in a loop at the terminal 
you can rub it out. 

glob wordlist . . _ , .. .. . 

Like echo but no ‘V escapes are recognized and words are delimited 

by null characters in the output. Useful for programs which wish to 
use the shell to filename expand a list of words. 


goto word . . , ... 

The specified word is filename and command expanded to yield a 
string of the form ’label’. The shell rewinds its input as much as pos¬ 
sible and searches for a line of the form ’label:' possibly preceded by 
blanks or tabs. Execution continues after the specified line. 


hashstat^ ^ stalislics line indicating how effective the internal hash table 
has been at locating commands (and avoiding exec's). An exec is 
attempted for each component of the path where the hash function 
indicates a possible hit. and in each component which does not 
begin with a V. 

history 
history n 
history —r n 
history —h n 

Displays the history event list; if n is given only the n most recent 
events are printed. The —r option reverses the order of printout to 
be most recent first rather than oldest first. The —h option causes 
the history list to be printed without leading numbers. This is used 
to produce files suitable for sourceing using the -h option to source. 


if (expr) command 

If the specified expression evaluates true, then the single command 
with arguments is executed. Variable substitution on command hap¬ 
pens early, at the same time it does for the rest of the if command. 
Command must be a simple command, not a pipeline, a command 
list, or a parenthesized command list. Input/output redirection 
occurs even if expr is false, when command is not executed (this is a 
bug). 

if (expr) then 
else if (expr2) then 


else 


If the specified expr is true then the commands to the first else are 
executed; else if expr2 is true then the commands to the second else 
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are executed, etc. Any number of else-if pairs are possible- onlv 
endrf is needed. The else part is 

and endif must appear at the beginning of input lines; the if must 
appear alone on its input line or after an else.) 

jobs 
jobs —1 

" opUons ,ists proce “ id ' s ln 

kill Xjob 
kill —sig Xjob ... 
kill pid 

kill —sig pid ... 
kill -1 

fhP lh K TERM (terminate ) signal or the specified signal to 

the specified jobs or processes. Signals are either given by number 

Zeti 55?*? ( TK giVen , in ^/^fude/st gnal.h, stripped of the 
prefix SIG ). The signal names are listed by “kill -1". There is no 

default, saying just 'kill' does not send a signal to the current job. 

limit 

limit resource 

limit resource maximum-use 

Limits the consumption by the current process and each process it 
creates to not individually exceed maximum-use on the specified 
resource. If no maximum-use is given, then the current limit is 
printed; if no resource is given, then all limitations are given. 

Resources controllable currently include cputime (the maximum 
number of cpu-seconds to be used by each process), filesize (the 
largest single file which can be created), datasize (the maximum 
growth of the data+stack region via sbrk( 2) beyond the end of the 
pr-ogr-am text), stacksize (the maximum size of the automatically- 
extended stack region), and coredumpsize (the size of the largest 
core dump that will be created). 

The maximum-use may be given as a (floating point or integer) 
number followed by a scale factor. For all limits other than cputime 
the default scale is 'k' or 'kilobytes' (1024 bytes); a scale factor of 
m or 'megabytes' may also be used. For cpuftme the default scaling 
is 'seconds', while 'm' for minutes or 'h' for hours, or a time of the 
form mm:ss’ giving minutes and seconds may be used. 

For both resource names and scale factors, unambiguous prefixes of 
the names suffice. 


login 

Terminate a login shell, replacing it with an instance of /bin/login. 
This is one way to log off. included for compatibility with sh(l). 
logout 

Terminate a login shell. Especially useful if ignoreeof is set. 

nice 

nice -fnumber 
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nice command 

nice +number command 

The first form sets the nice for this shell to 4. The second form sets 
the nice to the given number. The final two forms run command at 
priority 4 and number respectively. The super-user may specify 
negative niceness by using 'nice —number Command is always 
executed in a sub-shell, and the restrictions place on commands in 
simple if statements apply. 


nohup 

nohup command 

The first form can be used in shell scripts to cause hangups to be 
ignored for the remainder of the script. The second form causes the 
specified command to be run with hangups ignored. All processes 
detached with '&' are effectively nohup ed. 


notify 

notify %job ... 

Causes the shell to notify the user asynchronously when the status 
of the current or specified jobs changes; normally notification is 
presented before a prompt. This is automatic if the shell variable 
notify is set. 


onintr 
onintr — 

onintr label A , 

Control the action of the shell on interrupts. The first form restores 
the default action of the shell on interrupts which is to terminate 
shell scripts or to return to the terminal command input level. The 
second form 'onintr -* causes all interrupts to be ignored. The final 
form causes the shell to execute a 'goto label' when an interrupt is 
received or a child process terminates because it was interrupted. 

In any case, if the shell is running detached and interrupts are being 
ignored, all forms of onintr have no meaning and interrupts con¬ 
tinue to be ignored by the shell and all invoked commands. 


popd 
popd +n 

Pops the directory stack, returning to the new top directory. With a 
argument '+n' discards the nth entry in the stack. The elements of 
the directory stack are numbered from 0 starting at the top. 

pushd 
pushd name 

pushd +n . , 

With no arguments, pushd exchanges the top two elements ol tne 

directory stack. Given a name argument, pushd changes to the new 
directory (ala cd) and pushes the old current working directory (as 
in csw) onto the directory stack. With a numeric argument, rotates 
the nth argument of the directory stack around to be the top ele¬ 
ment and changes to it. The members of the directory stack are 
numbered from the top starting at 0. 

rehash , . .. A . 

Causes the internal hash table of the contents of the directories in 
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the path variable to be recomputed. This is needed if new com¬ 
mands are added to directories in the path while you are logged in 
Iwn H^° U ° n y be "pessary if you add commands to one of y our 

one of the sy "em d'ire‘cSheT S pr ° eromn ’' r <*“>«'» «>. contents o/ 
repeat count command 

The specified command which is subject to the same restrictions as 

ti h mes 0T 7/o anC H m t ! ie ° nC lme Xf stateme nt above, is executed count 
times. I/O redirections occur exactly once, even if counf is 0. 

set 

set name 
set name=word 
set name[index]=word 
set name=(wordlist) 

The first form of the command shows the value of all shell variables 
Variables which have other than a single word as value print as a 
parenthes^ed word list. The second form sets name to the null 

S f ln fk f ° rm SCtS name t0 the single word. The fourth form 

sets the index th component of name to word; this component must 
already exist The final form sets name to the list of words in 
wordlist. In all cases the value is command and filename expanded. 

These arguments may be repeated to set multiple values in a single 
set command. Note however, that variable expansion happens for all 
arguments before any setting occurs. 

setenv name value 

Sets the value of environment variable name to be value, a single 
string. The most commonly used environment variable USER. TERM, 
and PATH are automatically imported to and exported from the csh 
variables user. term, and path; there is no need to use setenv for 
these. 

shift 

shift variable 

The members of argv are shifted to the left, discarding argv[ 1 1 It is 
an error for argv not to be set or to have less than one word as 

value The second form performs the same function on the specified 
variable. K 


source name 
source —h name 

The shell reads commands from name. Sbtirce commands may be 
nested; if they are nested too deeply the shell may run out of file 
descriptors. An error in a source at any level terminates all nested 
source commands. Normally input during source commands is not 
p aced on the history list; the -h option causes the commands to be 
placed in the history list without being executed. 

switch (string) 
case strl: 


breaksw 


Page 15 


February 17. 1984 








CSH(l) 


1IUNIX 


CSH(l) 


default: 

breaksw 

Cn Each case label is successively matched, against the specified string 
which is first command and filename expanded. The file metachar¬ 
acters *?' and may be used in the case labels, which are vari¬ 
able expanded. If none of the labels match before a -default’ label is 
found, then the execution begins after the default label. Each case 
label and the default label must appear at the beginning of a line. 
The command breaksw causes execution to continue after the 
endsw Otherwise control may fall through case labels and default 
labels as in C. If no label matches and there is no default, execution 
continues after the endsw. 


time 

time command . , .. ... 

With no argument, a summary of time used by this shell and its cnil- 

dren is printed. If arguments are given the specified simple com¬ 
mand is timed and a time summary as described under the time 
variable is printed. If necessary, an extra shell is created to print 
the time statistic when the command completes. 


umask 

umask value , 

The file creation mask is displayed (first form) or set to the specified 

value (second form). The mask is given in octal. Common values for 
the mask are 002 giving all access to the group and read and exe- 
cute access to others or 022 giving all access except no write access 
for users in the group or others. 

unalias pattern , , 

All aliases whose names match the specified pattern are discarded. 
Thus all aliases are removed by 'unalias It is not an error for 
nothing to be unaliased. 

UIlha Use of the internal hash table to speed location of executed pro¬ 
grams is disabled. 

unlimit resource 

un limit . , , 

Removes the limitation on resource. If no resource is specified, then 

all resource limitations are removed. 

unset pattern , 

All variables whose names match the specified pattern are removed. 
Thus all variables are removed by 'unset this has noticeably dis¬ 
tasteful side-effects. It is not an error for nothing to be unset. 

unsetenv pattern - 

Removes all variables whose name match the specified pattern from 
the-environment. See also the setenv command above and pnn- 
tenv( 1). 
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wait 

All background jobs are waited for. It the shell is interactive, then 
an interrupt can disrupt the wait, at which time the shell prints 
names and job numbers of all jobs known to be outstanding. 

while (expr) 
end 

While the specified expression evaluates non-zero, the commands 
between the while and the matching end are evaluated. Break and 
continue may be used to terminate or continue the loop prema¬ 
turely. (The while and end must appear alone on their input lines.) 
Prompting occurs here the first time through the loop as for the 
foreach statement if the input is a terminal. 

© 

© name = expr 
© name[index] = expr 

The first form prints the values of all the shell variables. The second 
form sets the specified name to the value of expr. If the expression 
contains *<', *>’, or *|’ then at least this part of the expression 
must be placed within *(' *)’• The third form assigns the value of expr 
to the index“th argument of name. Both name and its index th com¬ 
ponent must already exist. 

The operators *+=*, etc are available as in C. The space 

separating the name from the assignment operator is optional. 
Spaces are, however, mandatory in separating components of expr 
which would otherwise be single words. 

Special postfix ’++’ and *—' operators increment and decrement 
name respectively, i.e. ’© i++’. 

Pre-defined and environment variables 

The following variables have special meaning to the shell. Of these, argv, 
cwd, home, path, prompt, shell and status are always set by the shell. 
Except for cwd and status this setting occurs only at initialization; these 
variables will not then be modified unless this is done explicitly by the 
user. 

This shell copies the environment variable USER into the variable user. 
TERM into term, and HOME into home, and copies these back into the 
environment whenever the normal shell variables are reset. The environ¬ 
ment variable PATH is likewise handled; it is not necessary to worry 
about its setting other than in the file .cshrc as inferior csh processes will 
import the definition of path from the environment, and re-export it if 
you then change it. (It could be set once in the .login except that com¬ 
mands through nef(l) would not see the definition.) 

Set to the arguments to the shell, it is from this variable 
that positional parameters are substituted, i.e. '81' is 
replaced by ’Sargvfl]', etc. 

Gives a list of alternate directories searched to find sub¬ 
directories in chdir commands. 
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cwd 

echo 


hisichars 


history 


home 

ignoreeof 

mail 


noclobber 


noglob 

nonomatch 


notify 


The full pathname of the current directory. 

Set when the —x command line option is given. Causes 
each command and its arguments to be echoed just before 
it is executed. For non-builtin commands all expansions 
occur before echoing. Builtin commands are echoed 
before command and filename substitution, since these 
substitutions are then done selectively. 

Can be given a string value to change the characters used 
in history substitution. The first character of its value is 
used as the history substitution character, replacing the 
default character !. The second character of its value 
replaces the character t in quick substitutions. 

Can be given a numeric value to control the size of the his¬ 
tory list. Any command which has been referenced in this 
many events will not be discarded. Too large values of his¬ 
tory may run the shell out of memory. The last executed 
command is always saved on the history list. 

The home directory of the invoker, initialized from the 
environment. The filename expansion of refers to this 
variable. 

If set the shell ignores end-of-file from input devices which 
are terminals. This prevents shells from accidentally being 
killed by control-D's. 

The files where the shell checks for mail. This is done after 
each command completion which will result in a prompt, if 
a specified interval has elapsed. The shell says ‘You have 
new mail.* if the file exists with an access time not greater 
than its modify time. 

If the first word of the value of mail is numeric it specifies 
a different mail checking interval, in seconds, than the 
default, which is 10 minutes. 

If multiple mail files are specified, then the shell says 'New 
mail in name ' when there is mail in the file name. 

As described in the section on Input/output, restrictions 
are placed on output redirection to insure that files are 
not accidentally destroyed, and that '»’ redirections refer 
to existing files. 

If set, filename expansion is inhibited. This is most useful 
in shell scripts which are not dealing with filenames, or 
after a list of filenames has been obtained and further 
expansions are not desirable. 

If set, it is not an error for a filename expansion to not 
match any existing files; rather the primitive pattern is 
returned. It is still an error for the primitive pattern to be 
malformed, i.e. 'echo [’ still gives an error. 

If set. the shell notifies asynchronously of job completions. 
The default is to rather present job completions just before 
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path 

printing a prompt. 

Each word of the path variable specifies a directory in 
which commands are to be sought for execution. A null 
word specifies the current directory. If there is no path 
variable then only full path names will execute. The usual 
search path is V, ‘/bin* and Vusr/bin’. but this may vary 
from system to system. For the super-user the default 
search path is '/etc’, ‘/bin’ and Vusr/bin’. A shell which is 
given neither the -c nor the -t option will normally hash 
the contents of the directories in the path variable after 
reading .cshrc, and each time the path variable is reset. If 
new commands are added to these directories while the 
shell is active, it may be necessary to give the rehash or 
the commands may not be found. 

prompt 

The string which is printed before each command is read 
from an interactive terminal input. If a ’!’ appears in the 
string it will be replaced by the current event number 
unless a preceding ’\ ’ is given. Default is ’% ’. or ’# ' for the 


super-user. 

savehist is given a numeric value to control the number of entries 


shell 

of the history list that are saved in -/.history when the 
user logs out. Any command which has been referenced in 
this many events will be saved. During start up the shell 
sources -/.history into the history list enabling history to 
be saved across logins. Too large values of savehist will 
slow down the shell during start up. 

The file in which the shell resides. This is used in forking 
shells to interpret files which have execute bits set. but 
which are not executable by the system. (See the descrip¬ 
tion of Non-builtin Command Execution below.) Initialized 
to the (system-dependent) home of the shell. 

status 

The status returned by the last command. If it terminated 
abnormally, then 0200 is added to the status. Builtin com¬ 
mands which fail return exit status ’l*, all other builtin 
commands set status ’O’. 

time 

Controls automatic timing of commands. If set, then any 
command which takes more than this many cpu seconds 
will cause a line giving user, system, and real times and a 
utilization percentage which is the ratio of user plus sys- 


tern times to real time to be printed when it terminates. 

verbose Set by the —v command line option, causes the words of 
each command to be printed after history substitution. 

Non-builtin command execution 

When a command to be executed is found to not be a builtin command 
the shell attempts to execute the command via exec(2). Each word in the 
variable path names a directory from which the shell will attempt to exe¬ 
cute the command. If it is given neither a —c nor a — t option, the shell 
will hash the names in these directories into an internal table so that it 
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will only try an exec in a directory if there is a possibility that the com¬ 
mand resides there. This greatly speeds command location when a large 
number of directories are present in the search path. If this mechanism 
has been turned off (via unhash), or if the shell was given a -« or -t 
argument, and in any case for each directory component of path which 
does not begin with a V. the shell concatenates with the given command 
name to form a path name of a file which it then attempts to execute. 

Parenthesized commands are always executed in a subshell. Thus '(cd ; 
pwd) ; pwd’ prints the home directory; leaving you where you were (print¬ 
ing this after the home directory), while 'cd ; pwd' leaves you m the home 
directory. Parenthesized commands are most often used to prevent 
chdir from affecting the current shell. 

If the file has execute permissions but is not an executable binary to the 
system, then it is assumed to be a file containing shell commands and a 
new shell is spawned to read it. 

If there is an alias for shell then the words of the alias will be prepended 
to the argument list to form the shell command. The first word of the 
alias should be the full path name of the shell (e.g. 'Sshell'). Note that 
this is a special, late occurring, case of alias substitution, and only allows 
words to be prepended to the argument list without modification. 

Argument list processing 

If argument 0 to the shell is then this is a login shell. The flag argu¬ 
ments are interpreted as follows: 

-c Commands are read from the (single) following argument which must 
be present. Any remaining arguments are placed in argv. 

—e The shell exits if any invoked command terminates abnormally or 
yields a non-zero exit status. 

The shell will start faster, because it will neither search for nor exe¬ 
cute commands from the file '.cshrc' in the invokers home directory. 

The shell is interactive and prompts for its top-level input, even if it 
appears to not be a terminal. Shells are interactive without this 
option if their inputs and outputs are terminals. 

Commands are parsed, but not executed. This may aid in syntactic 
checking of shell scripts. 


-f 


—l 


—n 


—s Command input is taken from the standard input. 

-t A single line of input is read and executed. A 'V may be used to 
escape the newline at the end of this line and continue onto another 
line. 

—v Causes the verbose variable to be set. with the effect that command 
input is echoed after history substitution. 

-x Causes the echo variable to be set. so that commands are echoed 
immediately before execution. 

—V Causes the verbose variable to be set even before .cshrc is exe¬ 
cuted. 
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—X Is to —x as — V is to — v. 

After processing of flag arguments if arguments remain but none of the 
—c, —i, —s, or —t options was given the first argument is taken as the 
name of a file of commands to be executed. The shell opens this file, and 
saves its name for possible resubstitution by ‘80’. Since many systems 
use either the standard version 6 or version 7 shells whose shell scripts 
are not compatible with this shell, the shell will execute such a ‘standard’ 
shell if the first character of a script is not a i.e. if the script does not 
start with a comment. Remaining arguments initialize the variable argv. 

Signal handling 

The shell normally ignores quit signals. Jobs running detached (ie. in the 
background) are immune to signals generated from the keyboard, includ¬ 
ing hangups. Other signals have the values which the shell inherited 
from its parent. The shells handling of interrupts and terminate signals 
in shell scripts can be controlled by onintr. Login shells catch the ter¬ 
minate signal; otherwise this signal is passed on to children from the 
state in the shell's parent. In no case are interrupts allowed when a login 
shell is reading the file ‘.logout’. 

AUTHOR 

William Joy. Job control and directory stack features first implemented 
by J.E. Kulp of l.I.A.S.A, Laxenburg. Austria, with different syntax than 
that used noi 

FILES 

~/.cshrc 
~/.login 
~/.logout 
/bin/sh 
/tmp/sh* 

/etc/passwd 

LIMITATIONS 

Words can be no longer than 1024 characters. The system limits argu¬ 
ment lists to 10240 characters. The number of arguments to a command 
which involves filename expansion is limited to 1/6’th the number of 
characters allowed in an argument list. Command substitutions may 
substitute no more characters than are allowed in an argument list. To 
detect looping, the shell restricts the number of alias substititutions on 
a single line to 20. 

SEE ALSO 

sh(l), access(2), execve(2), fork(2), killpg(2), pipe(2), sigsys(2). umask(2), 
setrlimit(2), wait(2), intro(3J), sigset(3), tty(4). a.out(5), environ(5). ’An 
introduction to the C shell' 

BUGS 

The PCS MUNIX 1.5 port of the cshell has none of the job control primi¬ 
tives such as bg, fg, stop... This is because we do not use the Berkeley sig¬ 
nals which are not in System V Unix. 

When a command is restarted from a stop, the shell prints the directory 
it started in if this is different from the current directory; this can be 
misleading (i.e. wrong) as the job may have changed directories 


Read at beginning of execution by each shell. 

Read by login shell, after ‘.cshrc’ at login. 

Read by login shell, at logout. 

Standard shell, for shell scripts not starting with a 
Temporary file for '<<’. 

Source of home directories for ‘~name’. 
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internally. 

Shell builtin functions are not stoppable/restartable. Command 
sequences of the form a ; b ; c’ are also not handled gracefully when 
stopping is attempted. If you suspend b , the shell will then immediately 
execute ’c'. This is especially noticeable if this expansion results from an 
alias. It suffices to place the sequence of commands in ()’s to force it to a 
subshell, i.e. *( a ; b ; c )'. 

Control over tty output after processes are started is primitive; perhaps 
this will inspire someone to work on a good virtual terminal interface. In 
a virtual terminal interface much more interesting things could be done 
with output control. 

Alias substitution is most often used to clumsily simulate shell pro¬ 
cedures; shell procedures should be provided rather than aliases. 

Commands’within loops, prompted for by ’?’, are not placed in the history 
list. Control structure should be parsed rather than being recognized as 
built-in commands. This would allow control commands to be placed any¬ 
where. to be combined with T. and to be used with ’&’ and metasyntax. 

It should be possible to use the *:* modifiers on the output of command 
substitutions. All and more than one modifier should be allowed on ’S' 
substitutions. 

Symbolic links fool the shell. In particular, dtrs and ’cd don’t work 
properly once you’ve crossed through a symbolic link. 
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NAME 

csplit — context split 
SYNOPSIS 

csplit [-s] [— k] [—f prefix] file argl [.. . argn] 

DESCRIPTION . , „ _ . _ 

Csplit reads file and separates it into n+1 sections, defined by the argu¬ 
ments argl... argn. By default the sections are placed in xxOO ... xxn 
(n may not be greater than 99). These sections get the following pieces 
of file : 

00: From the start of file up to (but not including) the line refer¬ 
enced by argl. 

01: From the line referenced by argl up to the line referenced by 
a rg2. 

n+1: From the line referenced by argn to the end of file. 

The options to csplit are: 

—s Csplit normally prints the character counts for each file 

created. If the —s option is present, csplit suppresses the 
printing of all character counts. 

—k Csplit normally removes created files if an error occurs. 

If the —k option is present, csplit leaves previously 
created files intact. 

-f prefix If the — f option is used, the created files are named 
prefix 00 . . . prefixn. The default is xxOO . . . xxn. 

The arguments {argl . .. argn) to csplit can be a combination of the fol¬ 
lowing: 

/ rexp / 

A file is to be created for the section from the current line 
up to (but not including) the line containing the regular 
expression rexp. The current line becomes the line contain¬ 
ing rexp. This argument may be followed by an optional +or 
- some number of lines (e.g., /Page/-5). 

7.rexp7. . 

This argument is the same as /rexp/, except that no file is 

created for the section. 

Inno A file is to be created from the current line up to (but not 
including) Inno. The current line becomes Inno. 

jnumj Repeat argument. This argument may follow any of the 
above arguments. If it follows a rexp type argument, that 
argument is applied num more times. If it follows Inno, the 
file will be split every Inno lines (num times) from that 
point. 

Enclose all rexp type arguments that contain blanks or other characters 
meaningful to the Shell in the appropriate quotes. Regular expressions 
may not contain embedded new-lines. Csplit does not affect the original 
file; it is the users responsibility to remove it. 
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EXAMPLES , . , m . . , 

csplit — f cobol file ’/procedure division/ /par5./ /parlo./ 

This example creates four files, cobolOO ... cobol03. After editing the 
••split” files, they can be recombined as follows: 

cat cobol0[0—3] > file 

Note that this example overwrites the original file, 
csplit —k file 100 (99{ 

This example would split the file at every 100 lines, up to 10,000 lines. 
The —k option causes the created files to be retained if there are less 
than 10,000 lines; however, an error message would still be printed. 

csplit -k prog.c ’%main(%' '/~j/ + l' |20J 

Assuming that prog.c follows the normal C coding convention of ending 
routines with a { at the beginning of the line, this example will create a 
file containing each separate C routine (up to 21) in prog.c. 

SEE ALSO 

ed(l). sh(l). regexp(7). 

DIAGNOSTICS 

Self explanatory except for: 

arg - out of range 

which means that the given argument did not reference a line between 
the current position and the end of the file. 
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NAME 

ctags - create a tags file 
SYNOPSIS 

ctags [ -u ][-▼][ -w ] [ -x ] name ... 

DESCRIPTION 

Ctags makes a tags file for ex(l) from the specified C. Pascal and Fortran 
sources. A tags file gives the locations of specified objects (in this case 
functions) in a group of files. Each line of the tags file contains the func¬ 
tion name, the file in which it is defined, and a scanning pattern used to 
find the function definition. These are given in separate fields on the 
line, separated by blanks or tabs. Using the tags file, ex can quickly find 
these function definitions. 

If the -x flag is given, ctags produces a list of function names, the line 
number and file name on which each is defined, as well as the text of that 
line and prints this on the standard output. This is a simple index which 
can be printed out as an off-line readable function index. 

If the -▼ flag is given, an index of the form expected by vgrind(l) is pro¬ 
duced on the standard output. This listing contains the function name, 
file name, and page number (assuming 64 line pages). Since the output 
will be sorted into lexicographic order, it may be desired to run the out¬ 
put through sort—f. Sample use: 

ctags —v files | sort —f > index 
vgrind —x index 

Files whose name ends in .c or .h are assumed to be C source files and 
are searched for C routine and macro definitions. Others are first exam¬ 
ined to see if they contain any Pascal or Fortran routine definitions; if 
not. they are processed again looking for C definitions. 

Other options are: 

—w suppressing warning diagnostics. 

—u causing the specified files to be updated in tags, that is, all refer¬ 
ences to them are deleted, and the new values are appended to the 
file. (Beware: this option is implemented in a way which is rather 
slow; it is usually faster to simply rebuild the tags file.) 

The tag main is treated specially in C programs. The tag formed is 
created by prepending M to the name of the file, with a trailing .c 
removed, if any, and leading pathname components also removed. This 
makes use of ctags practical in directories with more than one program. 

FILES 

tags output tags file 

SEE ALSO 

ex(l), vi(l) 

AUTHOR 

Ken Arnold; FORTRAN added by Jim Kleckner; Bill Joy added Pascal and 
—x, replacing cxref. 

BUGS 

Recognition of functions, subroutines and procedures for FORTRAN and 
Pascal is done is a very simpleminded way. No attempt is made to deal 
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with block structure; if you have two Pascal procedures in different 
blocks with the same name you lose. 

The method of deciding whether to look for C or Pascal and FORTRAN 
functions is a hack. 
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speed ] [ —a acu ] [ —1 line ] [ —E eotc ] 


NAME 

cu - call UNIX 

SYNOPSIS 

cu telno [ —t ] [ 

DESCRIPTION 

Cu calls up another UNIX system, a terminal, or possibly a non-UNIX sys¬ 
tem. It manages an interactive conversation with possible transfers of 
text files. Telno is the telephone number, with minus signs at appropri¬ 
ate places for delays. The —t flag is used to dial out to a terminal. Speed 
gives the transmission speed (110. 134, 150, 300, 1200); 300 is the default 
value. 

The —a and —1 values may be used to specify pathnames for the ACU and 
communications line devices. They can be used to override the following 
built-in choices: 

—a /dev/cuaO —1 /dev/culO 

The —E option changes the EOT character from CTRL-Z to the (decimal) 
value eotc. For file transfer to a different UNIX system often the option 
—E 4 must be given to set EOT to CTRL-D. 

After making the connection, cu runs as two processes: the send process 
reads the standard input and passes most of it to the remote system; the 
receive process reads from the remote system and passes most data to 
the standard output. Lines beginning with have special meanings. 

The send process interprets the following: 

~ . terminate the conversation. 

~E0T terminate the conversation 

~<file send the contents of file to the remote system, as 

though typed at the terminal. 

~! invoke an interactive shell on the local system. 

~!cmd ... run the command on the local system (via sh -c). 

~Scmd ... run the command locally and send its output to the 

remote system. 

~%take from [to] 

copy file ‘from’ (on the remote system) to file 'to' on the 
local system. If ‘to’ is omitted, the ‘from’ name is used 
both places. 

~%put from [to] copy file ‘from’ (on local system) to file *to’ on remote 
system. If ’to’ is omitted, the ’from’ name is used both 
places. 

send the line *~...\ 

The receive process handles output diversions of the following form." 
~>[>][:]file 

zero or more lines to be written to file 
~> 

In any case, output is diverted (or appended, if *>>’ used) to the file. If 
is used, the diversion is silent, i.e., it is written only to the file. If is 
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omitted, output is written both to the file and to the standard output. 
The trailing *~>' terminates the diversion. 

The use of ~%put requires stty and eat on the remote side. It also 
requires that the current erase and kill characters on the remote system 
be identical to the current ones on the local system. Backslashes are 
inserted at appropriate places. 


The use of ~Jttake requires the existence of echo and tee on the remote 
system. Also, stty tabs mode is required on the remote system if tabs are 
to be copied without expansion. 


EXAMPLE 

cu -t -s 


9600 -a /dev/null -1 /dev/tty30 


FILES 

/dev/cuaO 

/dev/culO 

/dev/null 


SEE ALSO 

dn(4). tty(4) 


DIAGNOSTICS 

Exit code is zero 


for normal exit, nonzero (various values) otherwise. 


BUGS 

The syntax is unique. 
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NAME 

cut — cut out selected fields of each line of a file 
SYNOPSIS 

cut —clist [filel file2 ...] 

cut —flist [—dchar] [—s] [filel file2 ...] 

DESCRIPTION 

Use cut to cut out columns from a table or fields from each line of a file; 
in data base parlance, it implements the projection of a relation. The 
fields as specified by list can be fixed length, i.e., character positions as 
on a punched card (—c option), or the length can vary from line to line 
and be marked with a field delimiter character like fab (—f option). Out 
can be used as a filter; if no files are given, the standard input is used. 

The meanings of the options are: 

List A comma-separated list of integer field numbers (in increasing 
order), with optional — to indicate ranges as in the —o option of 
nroff/troff for page ranges; e.g., 1,4,7; 1—3,8; —5,10 (short for 
1—5,10); or 3— (short for third through last field). 

—clist The list following —c (no space) specifies character positions 
(e.g., —cl—72 would pass the first 72 characters of each line). 

—f list The list following —f is a list of fields assumed to be separated in 

the file by a delimiter character (see —d ); e.g. . —fl.7 copies the 
first and seventh field only. Lines with no field delimiters will be 
passed through intact (useful for table subheadings), unless —s 
is specified. 

—dchar The character following -d is the field delimiter (-f option only). 

Default is tab. Space or other characters with special meaning 
to the shell must be quoted. 

—s Suppresses lines with no delimiter characters in case of —f 

option. Unless specified, lines with no delimiters will be passed 
through untouched. 

Either the —c or —f option must be specified. 

HINTS 

Use grep (1) to make horizontal "cuts” (by context) through a file, or 
j>asfe(l) to put files together column-wise (i.e., horizontally). To reorder 
columns in a table, use cuf andpasfe. 

EXAMPLES 

cut —d: — fl,5 /etc/passwd 

mapping of user IDs to names 

name = 'who am i | cut —fl —d" 

to set name to current login name. 


DIAGNOSTICS 

line too long A line can have no more than 511 characters or fields. 
bad list for c /f option 

Missing —c or —f option or incorrectly specified list. No 
error occurs if a line has fewer fields than the list calls for. 
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no fields The list is empty. 

SEE ALSO 

grep(l). paste(l). 
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NAME 

d — text database functions 
DESCRIPTION 

cf is a set of functions that work on Unix text files with records' like: 

from. Smith to.* Jones date.* 15.5 rei Unix jobs 
or: 

Title: What is the Title of this Book? 

Author: R.M.Smullyan 

Year: 1978 

Subjects: logic, games, paradox 

or Usenet mail, or a software project database like [Knudsen]. 

d is designed for small text databases like these, where 

• the familiar, fast screen editor can edit the data 

• Unix tools sort, grep, awk, join ... all work 

• the size and cost of a big database system would be overkill. 

d line, d record, d get, d form: 

d has four subcommands: 

d {Line \ record | get \form\ [opfions] [files, or stdin] 

line, record, get, form may be abbreviated l, r, g, J . 

d line 

makes each record into a single Tine’, for sort or awk or ... 
d record 

undoes d line in: 

d line afile 

where d line 

Unix-filter 
d record 

d get aword 

gets all records contining ’aword’, like a fast 
d line \ fgrep aword | d record 

d form aformfile 

puts fields from the data base into a form, such as: 

Dear (Name), 

In reply to your {Adjective} letter of {Date}, 

or simply selects some fields: 

{Phone} (Name} . 

EXAMPLES 

d get Edinburgh eunet.map 

looks in the eunet map for people in Edinburgh. 


| Unix-filter j d record 

flattens each record to one line, 
sorts or awks ... the lines, and 
makes each line back into a record. 
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d line Kproject \ sort -f|'-r+2 | dree 
sorts project records on field 3. 


d record format 

A record is a group of lines, followed by a blank line. A field is 'Field- 
name: Value’, where ’Value’ is everything up to the next ’Fieldname’: a 
word, a line, or several lines. ’Value’ may contain a but not right after 
a letter or number. 

d line separates fields with a T field separator ( awk FS, sort--t ). d 
record then deletes all ’|’s, so that d line | d record does nothing. 

d Line also changes newlines in multi-line records to an ersatz newline, 
default ’V, which d record changes back to \n. To specify your own 
field-separator and newline characters (which must not occur in the 
data): 

dsep= FN'; export dsep . 
dsep= )\ ' is the default. 

C interface 

d is only a few pages of C code, so it can be easily tailored or extended: 

#include "field.h" 

typedefs a struct field, which holds pointers to fieldname, fieldval 
etc. 

nf = get Fields ( char*rec, field f[]) 

splits rec into ’fieldname: value’ pairs, filling/! 0.. nf-l], 

char* get Para ( char nl ) 

returns the next paragraph (lines up to \n\n) from the open 
file Paralnfile. The text is buffered inside getPara. Paragraphs 
may be no longer than 4096 bytes. \n s are changed to nl. 

Possible extensions: 

More complicated gets, such as d get ‘Duedate > 15.5 '. 

Dates. 

Iget, interactive get. 

References 

Knudsen D.B. et al, "A Modification Request Control System”, in Proc. 
2nd International Conference on Software Engineering, San Francisco, 
1976, pp. 187-192. 

Author 

Denis Bzowy, PCS, (089) 67804-275, April 1983. 
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SEE ALSO 

awk(l), cut(l), join(l), sort(l), dbm(3X), table(3-pcs) 

BUGS 

Sort, awk etc. may misbehave on records longer than 256 or 512 bytes. 
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NAME 

date - print and set the date 
SYNOPSIS 

date [ mmddhhmm[yy] ] [ +format ] 

DESCRIPTION 

If no argument is given, or if the argument begins with +, the current 
date and time are printed. Otherwise, the current date is set. The first 
mm is the month number; dd is the day number in the month; hh is the 
hour number (24 hour system); the second mm is the minute number- yy 
is the last 2 digits of the year number and is optional. For example: 

date 10080045 


sets the date to Oct 8. 12:45 AM. The current year is the default if no 
year is mentioned. The system operates in GMT. Date takes care of the 
conversion to and from local standard and daylight time. 

If the argument begins with +, the output of date is under the control of 
the user. The format for the output is similar to that of the first argu¬ 
ment to printf(3S). All output fields are of fixed size (zero padded if 
necessary). Each field descriptor is preceded by % and will be replaced in 
the output by its corresponding value. A single % is encoded by %55. All 
other characters are copied to the output without change. The string is 
always terminated with a new-line character. 


Field Descriptors: 

n insert a new-line character 
t insert a tab character 
m month of year — 01 to 12 
d day of month — 01 to 31 
y last 2 digits of year - 00 to 99 
D date as mm/dd/yy 
H hour — 00 to 23 
M minute — 00 to 59 

S second - 00 to 59 

T time as HH:MM:SS 

j day of year - 001 to 366 

w day of week — Sunday = 0 
a abbreviated weekday — Sun to Sat 
h abbreviated month - Jan to Dec 
r time in AM/PM notation 

EXAMPLE 


date '+DATE: %m/%d/%y%nTIME: 
would have generated as output: 

DATE: 08/01/76 
TIME:. 14:45:05 

DIAGNOSTICS 


FILES 


No permission 

bad conversion 
bad format character 


if you aren’t the super-user and you try to change 
the date; 

if the date set is syntactically incorrect; 
if the field descriptor is not recognizable. 


/dev/kmem 
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WARNING 

It is a bad practice to change the date while the system is running 
multi-user. 
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NAME 

dbadd — add entry to an Emacs data base 
dbcreate — create an Emacs data base 
dbiist — list contents of an Emacs data base 
dbprint — print an entry from an Emacs data base 

SYNOPSIS 

dbadd dbname key 
dbcreate dbname 

dbiist dbname [ -1 ] [ -p newdbname ] 
dbprint dbname key 

DESCRIPTION 

All of these commands deal with databases used by the Unix Emacs data¬ 
base manipulation facilities. A Unix Emacs database is simply a set of 
(key.content) pairs, as in dbm(3X), except that the content part can be a 
very long string. 

Dbadd adds the text from the standard input to the named database 
using the given key. Dbcreate creates the named database, making it 
empty. Dbprint prints the contents of the entry from the database with 
the given key. 

Dbiist with no arguments simply lists the keys of all he items in the data¬ 
base. With the -1 option it prints some internal information from the 
database of no interest to anyone but the implementor. The -p option 
causes the key and content of every entry to be listed as a shell com¬ 
mand file which when executed will repeatedly invoke dbadd to rebuild 
the database. This form of dbiist is handy when you want a readable 
ascii file representation of a data base for shipping around or editing. 
Databases should be recreated periodically to garbage collect them. 


FILES 

dbname. dir, dbname.pag, and dbname. dat: the three component subfiles 
of a database. 

SEE ALSO 

James Gosling, The Unix Emacs Manual 

emacs(l), dbm (3X) from which much code was stolen. 


AUTHOR 

James Gosling @ CMU 
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NAME 

dc — desk calculator 

SYNOPSIS 

dc [ file ] 

DESCRIPTION 

Dc is an arbitrary precision arithmetic package. Ordinarily it operates 
on decimal integers, but one may specify an input base, output base, and 
a number of fractional digits to be maintained. The overall structure of 
dc is a stacking (reverse Polish) calculator. If an argument is given, 
input is taken from that file until its end. then from the standard input. 
The following constructions are recognized: 

number 

The value of the number is pushed on the stack. A number is an 
unbroken string of the digits 0-9. It may be preceded by an under¬ 
score _ to input a negative number. Numbers may contain decimal 
points. 

+ - / • % ~ 

The top two values on the stack are added (+), subtracted (-). mul¬ 
tiplied (*), divided (/), remaindered (%), or exponentiated (~). The 
two entries are popped off the stack; the result is pushed on the 
stack in their place. Any fractional part of an exponent is ignored. 

sx The top of the stack is popped and stored into a register named x, 
where x may be any character. If the s is capitalized, x is treated 
as a stack and the value is pushed on it. 

lx The value in register x is pushed on the stack. The register x is not 
altered. All registers start with zero value. If the 1 is capitalized, 
register x is treated as a stack and its top value is popped onto the 
main stack. 

d The top value on the stack is duplicated. 

p The top value on the stack is printed. The top value remains 
unchanged. P interprets the top of the stack as an ascii string, 
removes it. and prints it. 

f All values on the stack and in registers are printed. 

q exits the program. If executing a string, the recursion level is 
popped by two. If q is capitalized, the top value on the stack is 
popped and the string execution level is popped by that value. 

x treats the top element of the stack as a character string and exe¬ 
cutes it as a string of dc commands. 

X replaces the number on the top of the stack with its scale factor. 

[ ... ] puts the bracketed ascii string onto the top of the stack. 

<x >x =x 

The top two elements of the stack are popped and compared. 
Register x is executed if they obey the stated relation. 

v replaces the top element on the stack by its square root. Any exist¬ 
ing fractional part of the argument is taken into account, but oth¬ 
erwise the scale factor is ignored. 
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! interprets the rest of the line as a UNIX command, 
c All values on the stack are popped. 

i The top value on the stack is popped and used as the number radix 
for further input. I pushes the input base on the top of the stack. 

o The top value on the stack is popped and used as the number radix 
for further output. 

0 pushes the output base on the top of the stack. 

k the top of the stack is popped, and that value is used as a non¬ 
negative scale factor: the appropriate number of places are printed 
on output, and maintained during multiplication, division, and 
exponentiation. The interaction of scale factor, input base, and 
output base will be reasonable if all are changed together. 

z The stack level is pushed onto the stack. 

Z replaces the number on the top of the stack with its length. 

? A line of input is taken from the input source (usually the terminal) 

and executed. 

;: are used by 6c for array operations. 

An example which prints the first ten values of .n! is 

[lal+dsa*plalO>y]sy 

Osal 

lyx 

SEE ALSO 

bc(l), which is a preprocessor for dc providing infix notation and a C-like 
syntax which implements functions and reasonable control structures 
for programs. 

DIAGNOSTICS 

’x is unimplemented' where x is an octal number. 

'stack empty' for not enough elements on the stack to do what was 
asked. 

'Out of space' when the free list is exhausted (too many digits). 

'Out of headers' for too many numbers being kept around. 

'Out of pushdown' for too many items on the stack. 

'Nesting Depth' for too many levels of nested execution. 
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NAME 

dd — convert and copy a file 
SYNOPSIS 

dd [option=value] ... 


DESCRIPTION 

Dd copies the specified input file to the specified output with possible 
conversions. The standard input and output are used by default. The 
input and output block size may be specified to take advantage of raw 
physical 1/0. 


option 

il=file 

ot=file 

ibs=n 

obs=n 

bs=n 


values 

input file name; standard input is default 
output file name; standard output is default 
input block size n bytes (default 512) 
output block size (default 512) 

set both input and output block size, superseding ibs and 
obs; also, if no conversion is specified, it is particularly 
efficient since no in-core copy need be done 


cbs=n 
skip=n 
seek=n 
count=n 
conv= ascii 
• ebcdic 
ibm 
lease 
ucase 
swab 


conversion buffer size 

skip n input records before starting copy 

seek n records from beginning of output file before copying 

copy only n input records 

convert EBCDIC to ASCII 

convert ASCII to EBCDIC 

slightly different map of ASCII to EBCDIC 

map alphabetics to lower case 

map alphabetics to upper case 

swap every pair of bytes 


noerror 


do not stop processing on an error 
sync pad every input record to ibs 
....... several comma-separated conversions 


Where sizes are specified, a number of bytes is expected. A number may 
end with k, b, or w to specify multiplication by 1024, 512, or 2 respec¬ 
tively; a pair of numbers may be separated by x to indicate a product. 

Cbs is used only if ascii or ebcdic conversion is specified. In the former 
case cbs characters are placed into the conversion buffer, converted to 
ASCII, and trailing blanks trimmed and new-line added before sending the 
line to the output. In the latter case ASCII characters are read into the 
conversion buffer, converted to EBCDIC, and blanks added to make up an 
output record of size cbs. 

After completion, dd reports the number of whole and partial input and 
output blocks. 


EXAMPLE 

This command will read an EBCDIC tape blocked ten 80-byte EBCDIC card 
images per record into the ASCII file x: 

dd if=/dev/rmtO of=x ibs=800 cbs=80 conv=ascii,lcase 

Note the use of raw magtape. Dd is especially suited to I/O on the raw 
physical devices because it allows reading and writing in arbitrary record 
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sizes. 

SEE ALSO 

cp(l). 

DIAGNOSTICS 

/+p records in(out) numbers of full and partial records read(written) 

BUGS 

The ASCII/EBCDIC conversion tables are taken from the 256 character 
standard in the CACM Nov, 1968. The ibm conversion, while less blessed 
as a standard, corresponds better to certain IBM print train conventions. 
There is no universal solution. 

New-lines are inserted only on conversion to ASCII; padding is done only 
on conversion to EBCDIC. These should be separate options. 
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NAME 

delta — make a delta (change) to an SCCS file 
SYNOPSIS 

delta [—rSID] [-s] [-n] [-glist] [-m[mrlist]] [-y[comment]] [-p] files 
DESCRIPTION 

Delta is used to permanently introduce into the named SCCS file changes 
that were made to the file retrieved by yef(l) (called the g-file, or gen¬ 
erated file). 

Delta makes a delta to each named SCCS file. If a directory is named. 
delta behaves as though each file in the directory were specified as a 
named file, except that non-SCCS files (last component of the path name 
does not begin with s.) and unreadable files are silently ignored. If a 
name of — is given, the standard input is read (see WARNINGS): each line 
of the standard input is taken to be the name of an SCCS file to be pro¬ 
cessed. 

Delta may issue prompts on the standard output depending upon certain 
keyletters specified and flags (see admin(l)) that may be present in the 
SCCS file (see -m and —y keyletters below). 

Keyletter arguments apply independently to each named file. 

—rSID Uniquely identifies which delta is to be made to the 

SCCS file. The use of this keyletter is necessary only if 
two or more outstanding gets for editing (get —e) on 
the same SCCS file were done by the same person 
(login name). The SID value specified with the —r 
keyletter can be either the SID specified on the get 
command line or the SID to be made as reported by the 
get command (see yef(l)). A diagnostic results if the 
specified SID is ambiguous, or. if necessary and omit¬ 
ted on the command line. 

Suppresses the-issue, on the standard output, of the 
created delta’s SID, as well as the number of lines 
inserted, deleted and unchanged in the SCCS file. 

Specifies retention of the edited g-file (normally 
removed at completion of delta processing). 

Specifies a list (see pef(l) for the definition of list) of 
deltas which are to be ignored when the file is 
accessed at the change level (SID) created by this 
delta. 

If the SCCS file has the ▼ flag set (see admtn(l)) then a 
Modification Request (MR) number must be supplied as 
the reason for creating the new delta. 

If —m is not used and the standard input is a terminal, 
the prompt MRs? is issued on the standard output 
before the standard input is read; if the standard 
input is not a terminal, no prompt is issued. The MRs? 
prompt always precedes the comments? prompt (see 
—y keyletter). 


—n 

-glist 


—m[mrlist] 
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MRs in a list are separated by blanks and/or tab char¬ 
acters. An unescaped new-line character terminates 
the MR list. 

Note that if the v flag has a value (see acfmtn(l)), it is 
taken to be the name of a program (or shell pro¬ 
cedure) which will validate the correctness of the MR 
numbers. If a non-zero exit status is returned from MR 
number validation program, delta terminates (it is 
assumed that the MR numbers were not all valid). 

—y[comment] Arbitrary text used to describe the reason for making 
the delta. A null string is considered a valid comment. 

If —y is not specified and the standard input is a termi¬ 
nal. the prompt comments? is issued on the standard 
output before the standard input is read; if the stan¬ 
dard input is not a terminal, no prompt is issued. An 
unescaped new-line character terminates the com¬ 
ment text. 

_p Causes delta to print (on the standard output) the 

SCCS file differences before and after the delta is 
applied in a diff(l) format. 


FILES 

All files of the form ?-file are explained in the Source Code Control System 
User's Guide. The naming convention for these files is also described 
there. 

g-file Existed before the execution of delta\ removed after 

completion of delta. 

p. file Existed before the execution of delta-, may exist after 

completion of delta. 

q. file Created during the execution of delta-, removed after 

completion of delta. 

x -fH e Created during the execution of delta; renamed to SCCS 

file after completion of delta. 

z .file Created during the execution of delta; removed during 

the execution of delta. 

{j.file Created during the execution of delta; removed after 

completion of delta. 

/usr/bin/bdiff Program to compute differences between the '•gotten” 
file and the g-file. 

Lines beginning with an SOH ASCII character (binary 001) cannot be 
placed in the SCCS file unless the SOH is escaped. This character has spe¬ 
cial meaning to SCCS (see sccsfile{ 5)) and will cause an error. 

A get of many SCCS files, followed by a delta of those files, should be 
avoided when the get generates a large amount of data. Instead, multiple 
get /delta sequences should be used. 

If the standard input (—) is specified on the delta command line, the —m 
(if necessary) and —y keyletters must also be present. Omission of these 
keyletters causes an error to occur. 
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SEE ALSO 

admin(l). bdiff(l). get(l). help(l). prs(l), sccsfile(5). 

Source Code Control System User’s Guide by L. E. Bonanni and C. A. 
Salemi. 


DIAGNOSTICS 

Use help{ l) for explanations. 
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NAME 

derofT - remove nrofT/trofl, tbl. and eqn constructs 
SYNOPSIS 

deroff [ -w ] [ -mx ] [ files ] 

DESCRIPTION 

Deroff reads each of the files in sequence and removes all troff{l) 
requests, macro calls, backslash constructs. e 7 n(l) constructs (between 
.EQ and .EN lines, and between delimiters), and tbl(l) descriptions, and 
writes the remainder of the file on the standard output. Deroff follows 
chains of included files (.so and .nx fro ff commands); if a file has already 
been included, a .so naming that file is ignored and a .nx naming that file 
terminates execution. If no input file is given, deroff reads the standard 
input. 

The -m option may be followed by an m. s, or 1. The resulting -mm or 
—ms option causes the mm or ms macros to be interpreted so that only 
running text is output (i.e.. no text from macro lines.) The -ml option 
forces the —mm option and also causes deletion of lists associated with 
the mm macros. 

If the -w option is given, the output is a word list, one "word" per line, 
with all other characters deleted. Otherwise, the output follows the origi¬ 
nal, with the deletions mentioned above. In text, a "word" is any string 
that contains at least two letters and is composed of letters, digits, 
ampersands (&). and apostrophes ('); in a macro call, however, a “word” 
is a string that begins with at least two letters and contains a total of at 
least three letters. Delimiters are any characters other than letters, 
digits, apostrophes, and ampersands. Trailing apostrophes and amper¬ 
sands are removed from "words." 

SEE ALSO 

eqn(l), tbl(l), troff(l). 

BUGS 

Deroff is not a complete troff interpreter, so it can be confused by subtle 
constructs. Most such errors result in too much rather than too little 
output. 

The -ml option does not handle nested lists correctly. 
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NAME 

df — report number of free disk blocks 
SYNOPSIS 

df [ —t ] [ —f ] [ file-systems ] 

DESCRIPTION 

Df prints out the number of free blocks and free i-nodes available for 
on-line file systems by examining the counts kept in the super-blocks; 
file-systems may be specified either by device name (e.g., /dev/rpl) or 
by mounted directory name (e.g., /usr). If the file-systems argument is 
unspecified, the free space on all of the mounted file systems is printed. 

The —t flag causes the total allocated block figures to be reported as well. 

If the —f flag is given, only an actual count of the blocks in the free list is 
made (free i-nodes are not reported). With this option, df will report on 
raw devices. 


FILES 

/dev/rf • 

/dev/rk* 

/dev/rp* 

/etc/mnttab 

SEE ALSO 

fsck(8), fs(5), mnttab(5). 
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NAME 


diction, explain - print wordy sentences, interactive thesaurus for die 
tion 


5YN ° P diction [ -ml ] [ -mm ][ -n ][ -f pfile J file ... 
explain 

“S finds all sentences In a document that cnUis Phrases from a 
data base of bad or wordy diction. Each phrase is bracketed with L J- 
Because diction runs dcro} before looking at the text, formatting header 
fifes should be included as part of the input. The default macro package 
-ms may be overridden with the flag -mm. The flag -ml which causes 
deroff to skip lists, should be used if the document contains many lists of 
non-sentences. The user may supply her/his own pattern file to be used 
in addition to the default file with -f pfile. If the flag n is also supplie 
the default file will be supressed. 

Explain is an interactive thesaurus for the phrases found by diction. 


SEE ALSO 

deroff(l) 


BUGS 


Use of non-standard formatting macros may cause incorrect sentence 
breaks. 
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NAME 

diff - differential file comparator 


SYNOPSIS 

diff [ —efbh ] filel file2 

DESCRIPTION , ....... 

Diff tells what lines must be changed in two files to bring them into 
agreement. If file 1 (file2) is the standard input is used. If filel (file2) 
is a directory, then a file in that directory whose file-name is the same as 
the file-name of file2 {filel) is used. The normal output contains lines of 
these forms: 


nl a n3,n4 
nl,n2 d n3 
nl,n2 c n3,n4 

These lines resemble ed commands to convert filel into The 

numbers after the letters pertain to file2. In fact, by exchanging 'a' for 
•d' and reading backward one may ascertain equally how to convert file2 
into filel. As in ed. identical pairs where nl = n2 or n3 = n4 are abbrevi¬ 
ated as a single number. 

Following each of these lines come all the lines that are affected in the 
first file flagged by •<’. then all the lines that are affected in the second 

file flagged by •>'. 

The —b option causes trailing blanks (spaces and tabs) to be ignored and 
other strings of blanks to compare equal. 

The -e option produces a script of a. c and d commands for the editor ed. 
which will recreate file2 from filel. The -f option produces a similar 
script, not useful with ed. in the opposite order. In connection with-e. 
the following shell program may help maintain multiple versions of a file. 
Only an ancestral file ($1) and a chain of version-to-version ed scripts 
(S2.S3,...) made by diff need be on hand. A 'latest version' appears on the 
standard output. 

(shift; cat 8*; echo 'l.Sp") | ed — SI 

Except in rare circumstances, diff finds a smallest sufficient set of file 
differences. 

Option -h does a fast, half-hearted job. It works only when changed 
stretches are short and well separated, but does work on files of unlim¬ 
ited length. Options —e and —f are unavailable with —h. 

FILES 

/tmp/d????? 

/usr/lib/diffh for —h 

SEE ALSO 

cmp(l), comm(l), ed(l) 

DIAGNOSTICS , . . . 

Exit status is 0 for no differences, 1 for some, 2 for trouble. 

Editing scripts produced under the —e or —f option are naive about 
creating lines consisting of a single V. 
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NAME 

difT3 - 3-way differential file comparison 
SYNOPSIS 

diff3 [ —ex3 ] filel file2 file3 
DESCRIPTION 

Diff3 compares three versions of a file, and publishes disagreeing ranges 
of text flagged with these codes: 

= === all three files differ 

= = = = 1 filel is different 

= = ==2 file2 is different 

= = ==3 file3 is different 

The type of change suffered in converting a given range of a given file to 
some other is indicated in one of these ways: 

f -.nl a Text is to be appended after line number nl in file f, 

where / = 1, 2, or 3. 

f :nl ,n2 c Text is to be changed in the range line nl to line n2. If nl 
— n2, the range may be abbreviated to nl. 

The original contents of the range follows immediately after a c indica¬ 
tion. When the contents of two files are identical, the contents of the 
lower-numbered file is suppressed. 

Under the —e option, difJ3 publishes a script for the editor ed that will 
incorporate into filel all changes between file2 and file3, i.e. the 
changes that normally would be flagged ==== and == == 3. Option x 
(—3) produces a script to incorporate only changes flagged ==== 
(====3). The following command will apply the resulting script to 'filel'. 

(cat script; echo 'l.Sp') | ed — filel 

FILES 

/tmp/d3????? 

/usr/lib/diff3 

SEE ALSO 

diff(l) 

BUGS 

Text lines that consist of a single Y will defeat —e. 

Files longer than 64K bytes won’t work. 
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NAME 

dircmp — directory comparison 

SYNOPSIS 

dircmp dirl dir2 

DESCRIPTION 

Dircmp examines dirl and dir2 and generates various tabulated infor¬ 
mation about the contents of the directories. Listings of files that are 
unique to each directory are generated in addition to a list that indi¬ 
cates whether the files common to both directories have the same con¬ 
tents. 

SEE ALSO 

cmp(l), diff(l). 
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NAME 

du — summarize disk usage 
SYNOPSIS 

du [ —ars ] [ names ] 

DESCRIPTION 

Du gives the number of blocks contained in all files and (recursively) 
directories within each directory and file specified by the names argu¬ 
ment. The block count includes the indirect blocks of the file. If names 
is missing, . is used. 

The optional argument —s causes only the grand total (for each of the 
specified names) to be given. The optional argument —a causes an entry 
to be generated for each file. Absence of either causes an entry to be 
generated for each directory only. 

Du is normally silent about directories that cannot be read, files that 
cannot be opened, etc. The —r option will cause du to generate messages 
in such instances. 

A file with two or more links is only counted once. 

BUGS 

If the —a option is not used, non-directories given as arguments are not 
listed. 

If there are too many distinct linked files, du will count the excess files 
more than once. 

Files with holes in them will get an incorrect block count. 
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NAME 

echo - echo arguments 

SYNOPSIS 

echo [ arg ] ... 

DESCRIPTION 

Echo writes its arguments separated by blanks and terminated by a new- 
line on the standard output. It also understands C-like escape conven¬ 
tions; beware of conflicts with the shell's use of \: 

\b backspace 

\ c print line without new-line 

\f form-feed 

\n new-line 

\r carriage return 

\t tab 

\\ backslash 

\n the 8-bit character whose ASCII code is the 1-, 2- or 3-digit 
octal number n, which must start with a zero. 

Echo is useful for producing diagnostics in command files and for sending 
known data into a pipe. 

SEE ALSO 

sh(l). 
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NAME 

ed, red — text editor 
SYNOPSIS 

ed [ - ] [ -x ] [ file ] 
red [ - ] [ -x ] [ file ] 

DESCRIPTION 

Ed is the standard text editor. If the/Me argument is given, ed simulates 
an e command (see below) on the named file; that is to say. the file is 
read into ecf’s buffer so that it can be edited. The optional — suppresses 
the printing of character counts by e, r, and w commands, of diagnostics 
from e and q commands, and of the ! prompt after a ! shell command. If 
—x is present, an x command is simulated first to handle an encrypted 
file. Ed operates on a copy of the file it is editing; changes made to the 
copy have no effect on the file until a w (write) command is given. The 
copy of the text being edited resides in a temporary file called the buffer. 
There is only one buffer. 

Red is a restricted version of ed. It will only allow editing of files in the 
current directory. It prohibits executing shell commands via 
l shell command. Attempts to bypass these restrictions result in an error 
message ( restricted shell). 

Both ed and red support the/spec (5) formatting capability. After includ¬ 
ing a format specification as the first line of file and invoking ed with 
your terminal in stty —tabs or stty tab3 mode (see sffy(l), the specified 
tab stops will automatically be used when scanning file. For example, if 
the first line of a file contained: 

<:t5,10,15 s72:> 

tab stops would be set at columns 5, 10 and 15. and a maximum line 
length of 72 would be imposed. NOTE: while inputting text, tab characters 
when typed are expanded to every eighth column as is the default. 

Commands to ed have a simple and regular structure: zero, one, or two 
addresses followed by a single-character command, possibly followed by 
parameters to that command. These addresses specify one or more lines 
in the buffer. Every command that requires addresses has default 
addresses, so that the addresses can very often be omitted. 

In general, only one command may appear on a line. Certain commands 
allow the input of text. This text is placed in the appropriate place in the 
buffer. While ed is accepting text, it is said to be in input mode. In this 
mode, no commands are recognized; all input is merely collected. Input 
mode is left by typing a period (.) alone at the beginning of a line. 

Ed supports a limited form of regular expression notation; regular 
expressions are used in addresses to specify lines and in some commands 
(e.g., s) to specify portions of a line that are to be substituted. A regular 
expression (RE) specifies a set of character strings. A member of this set 
of strings is said to be matched by the RE. The REs allowed by ed are 
constructed as follows: 

The following one-character REs match a single character: 

1.1 An ordinary character ( not one of those discussed in 1.2 below) is a 
one-character RE that matches itself. 
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1.2 A backslash (\) followed by any special character is a one- 
character RE that matches the special character itself. The special 
characters are: 

a __ • i [ t and \ (period, asterisk, left square bracket, and 
backslash, respectively), which are always special, except when 
they appear within square brackets ([]; see 1.4 below). 

b. ~ (caret or circumflex), which is special at the beginning of an 
entire RE (see 3.1 and 3.2 below), or when it immediately follows 
the left of a pair of square brackets ([)) (see 1.4 below). 

c. S (currency symbol), which is special at the end of an entire RE 
(see 3.2 below). 

d. The character used to bound (i.e., delimit) an entire RE, which 
is special for that RE (for example, see how slash (/) is used in 
the g command, below.) 

1.3 A period (.) is a one-character RE that matches any character 
except new-line. 

1.4 A non-empty string of characters enclosed in square brackets ([]) 
is a one-character RE that matches any one character in that, 
string. If, however, the first character of the string is a circumflex 
(■~), the one-character RE matches any character except new-line 
and the remaining characters in the string. The ~ has this special 
meaning only if it occurs first in the string. The minus (—) may be 
used to indicate a range of consecutive ASCII characters; for exam¬ 
ple. [0-9] is equivalent to [0123456789]. The - loses this special 
meaning if it occurs first (after an initial if any) or last in the 
string. The right square bracket (]) does not terminate such a 
string when it is the first character within it (after an initial -, if 
any); e.g.. []a-f] matches either a right square bracket (]) or one 
of the letters a through f inclusive. The four characters listed in 
1.2.a above stand for themselves within such a string of characters. 

The following rules may be used to construct REs from one-character 

REs: 

2.1 A one-character RE is a RE that matches whatever the one- 
character RE matches. 

2.2 A one-character RE followed by an asterisk (•) is a RE that matches 
zero or more occurrences of the one-character RE. If there is any 
choice, the longest leftmost string that permits a match is chosen. 

2.3 A one-character RE followed by \[m\], \[m,\j, or \{m,n\J is a 
RE that matches a range of occurrences of the one-character RE. 
The values of m and n must be non-negative integers less than 256; 
\[m\{ matches exactly m occurrences; \(m,\j matches at least 
m occurrences; \{wi,ti\{ matches any number of occurrences 
between m and n inclusive. Whenever a choice exists, the RE 
matches as many occurrences as possible. 

2.4 The concatenation of REs is a RE that matches the concatenation of 
the strings matched by each component of the RE. 
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2.5 A RE enclosed between the character sequences \( and \) is a RE 
that matches whatever the unadorned RE matches. 

2.6 The expression \n matches the same string of characters as was 
matched by an expression enclosed between \( and \) earlier in 
the same RE. Here n is a digit; the sub-expression specified is that 
beginning with the n-th occurrence of \( counting from the left. 
For example, the expression ~\(.*\)\ 1* matches a line consisting 
of two repeated appearances of the same string. 

Finally, an entire RE may be constrained to match only an initial segment 
or final segment of a line (or both): 

3.1 A circumflex (~) at the beginning of an entire RE constrains that RE 
to match an initial segment of a line. 

3.2 A currency symbol (S) at the end of an entire RE constrains that RE 
to match a final segment of a line. 

The construction * entire REX constrains the entire RE to match the 
entire line. 

The null RE (e.g.. //) is equivalent to the last RE encountered. See also 
the last paragraph before FILES below. 

To understand addressing in ed it is necessary to know that at any time 
there is a current line. Generally speaking, the current line is the last 
line affected by a comnjand; the exact effect on the current line is dis¬ 
cussed under the description of each command. Addresses are con¬ 
structed as follows: 

1. The character . addresses the current line. 

2. The character S addresses the last line of the buffer. 

3. A decimal number n addresses the n-th line of the buffer. 

4. '* addresses the line marked with the mark name character x, 
which must be a lower-case letter, lines are marked with the k 
command described below. 

5. A RE enclosed by slashes (/) addresses the first line found by 
searching forward from the line following the current line toward 
the end of the buffer and stopping at the first line containing a 
string matching the RE. If necessary, the search wraps around to 
the beginning of the buffer and continues up to and including the 
current line, so that the entire buffer is searched. See also the last 
paragraph before FILES below. 

6. A RE enclosed in question marks (?) addresses the first line found 
by searching backward from the line preceding the current line 
toward the beginning of the buffer and stopping at the first line 
containing a string matching the RE. If necessary, the search wraps 
around to the end of the buffer and continues up to and including 
the current line. See also the last paragraph before FILES below. 

7. An address followed by a plus sign ( + ) or a minus sign (-) followed 
by a decimal number specifies that address plus (respectively 
minus) the indicated number of lines. The plus sign may be omit¬ 
ted. 
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8 If an address begins with + or —, the addition or subtraction is 
taken with respect to the current line; e.g, -5 is understood to 

mean .—5. 

9 If an address ends with + or then 1 is added to or subtracted 
from the address, respectively. As a consequence of this rule and of 
rule 8 immediately above, the address - refers to the line preceding 
the current line. (To maintain compatibility with earlier versions of 
the editor, the character - in addresses is entirely equivalent to 
-) Moreover, trailing + and - characters have a cumulative effect. 
so — refers to the current line less 2. 

10. For convenience, a comma (.) stands for the address pair l.S. while 
a semicolon (;) stands for the pair 

Commands may require zero. one. or two addresses Commands that 
require no addresses regard the presence of an address as an error 
Commands that accept one or two addresses assume default addresses 
when an insufficient number of addresses is given; if more addresses are 
given than such a command requires, the last one(s) are used. 

Typically addresses are separated from each other by a comma (.). They 
may also be separated by a semicolon (;). In the latter case, the current 
line ( ) is set to the first address, and only then is the second address 
calculated This feature can be used to determine the sorting line for 
forward and backward searches (see rules 5. and 6. above). The ««nd 
address of any two-address sequence must correspondl to a line that fol 
lows, in the buffer, the line corresponding to the first address. 

In the following list of ed commands, the default addresses are shown in 
parentheses The parentheses are not part of the address; they show 
that the given addresses are the default. 

It is generally illegal for more than one command to appear on a line. 
However, any command (except e.f.r, or w) may be suffixed by U or p. 
fn which case the current line is either listed numbered or printed, 
respectively, as discussed below under the l , n and p commands. 

(-)a 

<text> 

The append command reads the given text and appends it after 
the addressed line; . is left at the last inserted line or if there 
were none, at the addressed line. Address 0 is legal for this com 
mand: it causes the "appended" text to be placed at the beginning 
of the buffer. The maximum number of characters that may 
entered from a terminal is 256 per line (including the newline 

character). 


(-)c 

<text> 




The change command deletes the addressed lines, then accepts 
input text 8 that replaces these lines; . is left at the last line input, 
or, if there were none, at the first line that was not deleted. 

The delete command deletes the addressed lines from the buffer. 
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The line after the last line deleted becomes the current line; if the 
lines deleted were originally at the end of the buffer, the new last 
line becomes the current line. 

e file 

The edit command causes the entire contents of the buffer to be 
deleted, and then the named file to be read in; . is set to the last 
line of the buffer. If no file name is given, the currently- 
remembered file name, if any, is used (see the / command). The 
number of characters read is typed; file is remembered for possi¬ 
ble use as a default file name in subsequent e, r, and w commands. 
If file is replaced by !. the rest of the line is taken to be a shell 
(sh{ 1)) command whose output is to be read. Such a shell com¬ 
mand is not remembered as the current file name. See also DIAG¬ 
NOSTICS below. 

E file 

The £dit command is like e, except that the editor does not check 
to see if any changes have been made to the buffer since the last 
w command. 

I file 

If file is given, the / ile-name command changes the currently- 
remembered file name to file\ otherwise, it prints the currently- 
remembered file name. 

( 1 ,%)g/RE/command list 

In the global command, the first step is to mark every line that 
matches the given RE. Then, for every such line, the given com¬ 
mand list is executed with . initially set to that line. A single com¬ 
mand or the first of a list of commands appears on the same line 
as the global command. All lines of a multi-line list except the last 
line must be ended with a \ ; a, t, and c commands and associated 
input are permitted; the . terminating input mode may be omitted 
if it would be the last line of the command list. An empty com¬ 
mand list is equivalent to thep command. The g. G.v, and V com¬ 
mands are nof permitted in the command list. See also BUGS and 
the last paragraph before FILES below. 

(l.S)G /RE/ 

In the interactive Global command, the first step is to mark every 
line that matches the given RE. Then, for every such line, that line 
is printed, . is changed to that line, and any one command (other 
than one of the a. c, i, g, G, v, and V commands) may be input and 
is executed. After the execution of that command, the next 
marked line is printed, and so on; a new-line acts as a null com¬ 
mand; an Sc causes the re-execution of the most recent command 
executed within the current invocation of G. Note that the com¬ 
mands input as part of the execution of the G command may 
address and affect any lines in the buffer. The G command can be 
terminated by an interrupt signal (ASCII DEL or BREAK). 

h 

The help command gives a short error message that explains the 
reason for the most recent ? diagnostic. 
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H 

The He Ip command causes ed to enter a mode in which error mes¬ 
sages are printed for all subsequent ? diagnostics. It will also 
explain the previous ? if there was one. The H command alter¬ 
nately turns this mode on and off; it is initially off. 

(•)> 

<text> 

The insert command inserts the given text before the addressed 
line; . is left at the last inserted line, or, if there were none, at the 
addressed line. This command differs from the a command only in 
the placement of the input text. Address 0 is not legal for this 
command. The maximum number of characters that may be 
entered from a terminal is 256 per line (including the newline 
character). 

(•••+1 )j 

The join command joins contiguous lines by removing the 
appropriate new-line characters. If exactly one address is given, 
this command does nothing. 

(.)kx 

The mart command marks the addressed line with name x, which 
must be a lower-case letter. The address 'x then addresses this 
line; . is unchanged. 

(..)! 

The fist command prints the addressed lines in an unambiguous 
way: a few non-printing characters (e.g., fab, backspace) are 
represented by (hopefully) mnemonic overstrikes, all other non¬ 
printing characters are printed in octal, and long lines are folded. 
An l command may be appended to any other command other 
than e,/, r, or w. 

(.,. )ma 

The move command repositions the addressed line(s) after the 
line addressed by a. Address 0 is legal for a and causes the 
addressed line(s) to be moved to the beginning of the file; it is an 
error if address a falls within the range of moved lines; . is left at 
the last line moved. 

(•• - ) n 

The number command prints the addressed lines, preceding each 
line by its line number and a tab character; . is left at the last line 
printed. The n command may be appended to any other command 
other than e, /, r, or w. 

The print command prints the addressed lines; . is left at the last 
line printed. The p command may be appended to any other com¬ 
mand other than e,/, r, or iu; for example, dp deletes the current 
line and prints the new current line. 

P 

The editor will prompt with a • for all subsequent commands. The 
P command alternately turns this mode on and off; it is initially 
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off. 

q 

The guit command causes ed to exit. No automatic write of a file 
is done (but see DIAGNOSTICS below). 

Q 

The editor exits without checking if changes have been made in 
the buffer since the last w command. 

<S)r file 

The read command reads in the given file after the addressed line. 
If no file name is given, the currently-remembered file name, if 
any. is used (see e and f commands). The currently-remembered 
file name is not changed unless file is the very first file name men¬ 
tioned since ed was invoked. Address 0 is legal for r and causes 
the file to be read at the beginning of the buffer. If the read is 
successful, the number of characters read is typed; . is set to the 
last line read in. If file is replaced by !, the rest of the line is 
taken to be a shell (sA(l)) command whose output is to be read. 
For example, "Sr !ls" appends current directory to the end of the 
file being edited. Such a shell command is nof remembered as the 
current file name. 

(.,.)s/RE/replacement / or 

(.,. )s/ RE /replacement /g 

The substitute command searches each addressed line for an 
occurrence of the specified RE. In each line in which a match is 
found, all (non-overlapped) matched strings are replaced by the 
replacement if the global replacement indicator g appears after 
the command. If the global indicator does not appear, only the 
first occurrence of the matched string is replaced. It is an error 
for the substitution to fail on all addressed lines. Any character 
other than space or new-line may be used instead of / to delimit 
the RE and the replacement-, . is left at the last line on which a 
substitution occurred. See also the last paragraph before FILES 
below. 

An ampersand (&) appearing in the replacement is replaced by the 
string matching the RE on the current line. The special meaning 
of tc in this context may be suppressed by preceding it by \. As a 
more general feature, the characters \n, where n is a digit, al-« 
replaced by the text matched by the n-th regular subexpression 
of the specified RE enclosed between \( and \). When nested 
parenthesized subexpressions are present, n is determined by 
counting occurrences of \( starting from the left. When the char¬ 
acter % is the only character in the replacement , the replacement 
used in the most recent substitute command is used as the 
replacement in the current substitute command. The 7, loses its 
special meaning when it is in a replacement string of more than 
one character or is preceded by a \. 

A line may be split by substituting a new-line character into it. 
The new-line in the replacement must be escaped by preceding it 
by \. Such substitution cannot be done as part of a g or v 
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command list. 

0..)ta 

This command acts just like the m command, except that a copy 
of the addressed lines is placed after address a (which may be 0); . 
is left at the last line of the copy. 

u 

The undo command nullifies the effect of the most recent com¬ 
mand that modified anything in the buffer, namely the most 
recent a, c, d , g, i,j, m, r, s, t, v, C, or V command. 

( 1, S )v/RE/command list 

This command is the same as the global command g except that 
the coTn.Tna.Tid List is executed with . initially set to every line that 
does not match the RE. 

( 1 ,%)V/RE/ 

This command is the same as the interactive global command G 
except that the lines that are marked during the first step are 
those that do nof match the RE. 

(1 ,%)n file 

The turite command writes the addressed lines into the named file. 
If the file does not exist, it is created with mode 666 (readable and 
writable by everyone), unless your umask setting (see s/i(l)) dic¬ 
tates otherwise. The currently-remembered file name is not 
changed unless file is the very first file name mentioned since ed 
was invoked. If no file name is given, the currently-remembered 
file name, if any. is used (see e and / commands); . is unchanged. 
If the command is successful, the number of characters written is 
typed. If file is replaced by !, the rest of the line is taken to be a 
shell (sA(l)) command whose standard input is the addressed 
lines. Such a shell command is nof remembered as the current file 
name. 

X 

A key string is demanded from the standard input. Subsequent e, 
r, and w commands will encrypt and decrypt the text with this key 
by the algorithm of crypf(l). An explicitly empty key turns off 
encryption. 

(*)= 

The line number of the addressed line is typed; . is unchanged by 
this command. 

\shelL command 

The remainder of the line after the ! is sent to the UNDC System 
shell (sh( 1)) to be interpreted as a command. Within the text of 
that command, the unescaped character % is replaced with the 
remembered file name; if a ! appears as the first character of the 
shell command, it is replaced with the text of the previous shell 
command. Thus, !! will repeat the last shell command. If any 
expansion is. performed, the expanded line is echoed; . is 
unchanged. 
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(.+ 1 )<new-line> 

An address alone on a line causes the addressed line to be printed. 
A new-line alone is equivalent to .+lp; it is useful for stepping for¬ 
ward through the buffer. 

If an interrupt signal (ASCII DEL or BREAK) is sent, ed prints a ? and 
returns to its command level. 

Some size limitations: 512 characters per line, 256 characters per global 
command list, 64 characters per file name, and 128K characters in the 
buffer. The limit on the number of lines depends on the amount of user 
memory: each line takes 1 word. 

When reading a file, ed discards ASCII NUL characters and all characters 
after the last new-line. Files (e.g., a.out) that contain characters not in 
the ASCII set (bit 8 on) cannot be edited by ed. 

If the closing delimiter of a RE or of a replacement string (e.g.. /) would 
be the last character before a new-line, that delimiter may be omitted, in 
which case the addressed line is printed. The following pairs of com¬ 
mands are equivalent: 

s/sl/s2 s/sl /s2/p 
g/sl g/Sl/p 

?sl ?sl? 

FILES 

/tmp/e# 

temporary; # is the process number, 
ed.hup work is saved here if the terminal is hung up. 

DIAGNOSTICS 

? for command errors. 

?file for an inaccessible file. 

(use the help and Help commands for detailed explanations). 

If changes have been made in the buffer since the last w command that 
wrote the entire buffer, ed warns the user if an attempt is made to des¬ 
troy ed 's buffer via the e or q commands: it prints ? and allows one to 
continue editing. A second e or q command at this point will take effect. 
The — command-line option inhibits this feature. 

SEE ALSO 

crypt(l), grep(l), sed(l). sh(l), stty(l), fspec(5), regexp(7). 

A Tutorial Introduction to the UNIX Text Editor by B. W. Kernighan. 
Advanced Editing on UNIX by B. W. Kernighan. 

CAVEATS AND BUGS 

A / command cannot be subject to a g or a v command. 

The ! command and the ! escape from the e, r, and w commands cannot 
be used if the the editor is invoked from a restricted shell (see sA(l)). 

The sequence \n in a RE does not match a new-line character. 

The l command mishandles DEL. 

Files encrypted directly with the crypt(l) command with the null key 
cannot be edited. 

Characters are masked to 7 bits on input. 
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NAME 

efl - Extended Fortran Language 
SYNOPSIS 

efl [ options ] [ files ] 

DESCRIPTION 

Efl compiles a program written in the EFL language into clean Fortran on 
the standard output. Efl provides the C-like control constructs of rat- 
for{ 1): 

statement grouping with braces, 
decision-making: 

if, if-else, and select-case (also known as switch-case); 
while, for, Fortran do, repeat, and repeat... until loops; 
multi-level break and next. 

EFL has C-like data structures, e.g.: 

struct 

I 

integer flags(3) 
character(8) name 
long real coords(2) 

| table(lOO) 

The language offers generic functions, assignment operators (+=, &=, 
etc.), and sequentially evaluated logical operators ( kk and |). There is a 
uniform input/output syntax: 

write(6,x,y:f(7,2), do i=1.10 f a(i,j),z.b(i) j) 

EFL also provides some syntactic "sugar”: 
free-form input: 

multiple statements per line; automatic continuation; state¬ 
ment label names (not just numbers). 

comments: 

# this is a comment. 

translation of relational and logical operators: 

>, >=, k, etc., become .GT., .GE., .AND., etc. 

return expression to caller from function: 
return ( expression ) 

defines: 

define name replacement 

includes: 

include file 

Efl understands several option arguments: —w suppresses warning mes¬ 
sages, —# suppresses comments in the generated program, and the 
default option —C causes comments to be included in the generated pro¬ 
gram. 

An argument with an embedded = (equal sign) sets an EFL option as if it 
had appeared in an option statement at the start of the program. Many 
options are described in the reference manual. A set of defaults for a 


Page 1 


February 17, 1984 



EFL(l) 


liUNIX 


EFL(l) 


particular target machine may be selected by one of the choices: 
system=unix, system=gcos, or system=cray The default setting of the 
system option is the same as the machine the compiler is running on. 
Other specific options determine the style of input/output, error han¬ 
dling. continuation conventions, the number of characters packed per 
word, and default formats. 

Efl is best used with/?7(l). 

SEE ALSO 

cc(l), f77(l), ratfor(l). 

The Programming Language EFL by S.I. Feldman. 
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NAME 

emacs — a screen editor 

SYNOPSIS 

emacs files... 

DESCRIPTION 

Unix Emacs is a text editor styled after the editors of the same name 
that exist on ITS, Twenex and Multics. Invoking emacs with a list of files 
causes emacs to start up and do a visit-file on each of the named files. 
For more information, read the manual. 

FILES 

/usr/lib/emacs/* 

ENVIRONMENT 

EPATH is a path used when locating files with the load command. 

SEE ALSO 

The Unix Emacs manual, which should be on /usr/doc/emacs 

BUGS 

Probably many on the CADMUS. Emacs needs virtual memory, as it grows 
very big. 

HISTORY 

08-Jan-81 James Gosling (jag) at Carnegie-Mellon University 
Created. 
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NAME 

env — set environment for command execution 

SYNOPSIS , . , , 

env [-] [ name=value ] ... [ command args J 

DESCRIPTION 

Env obtains the current environment, modifies it according to its argu¬ 
ments. then executes the command with the modified environment. 
Arguments of the form name=value are merged into the inherited 
environment before the command is executed. The - flag causes the 
inherited environment to be ignored completely, so that the command is 
executed with exactly the environment specified by the arguments. 

If no command is specified, the resulting environment is printed, one 
name-value pair per line. 

SEE ALSO 

sh(l), exec(2), profile(5). environ(7). 
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eqn, neqn, checkeq - format mathematical text for nroff or trofl 

SYNOPSIS , ; 

eqn [ —dxy ] [ —pn ] [ —an ] [ —fn ] [ files J 

neqn [ -dxy ] [ —pn ] [ -an ] [ —fn ] [ files ] 

checkeq [ files ] 


DESCRIPTION 

Eqn is a troff(l) preprocessor for typesetting mathematical text on a 
Wang Laboratories, Inc. C/A/T phototypesetter, while neqn is used for 
the same purpose with nrojf(l) on typewriter-like terminals. Usage is 
almost always: 

eqn files | troff 
neqn files | nroff 


or equivalent. 

If no files are specified, these programs read from the standard input. A 
line beginning with JIQ marks the start of an equation; the end of an 
equation is marked by a line beginning with JEN. Neither of these lines is 
altered, so they may be defined in macro packages to get centering, 
numbering, etc. It is also possible to designate two characters as delim¬ 
iters-, subsequent text between delimiters is then treated as eqn input. 
Delimiters may be set to characters * and y with the command-line argu¬ 
ment —dry or (more commonly) with delim xy between JIQ and JIN. The 
left and right delimiters may be the same character; the dollar sign is 
often used as such a delimiter. Delimiters are turned off by delim off. All 
text that is neither between delimiters nor between JIQ and .EN is passed 
through untouched. 

The program checkeq reports missing or unbalanced delimiters and 
.EQ/.EN pairs. 

Tokens within eqn are separated by spaces, tabs, new-lines, braces, dou¬ 
ble quotes, tildes, and circumflexes. Braces f j are used for grouping; 
generally speaking, anywhere a single character such as * could appear, 
a complicated construction enclosed in braces may be used instead. 
Tilde (~) represents a full space in the output, circumflex (~) half as 
much. 


Subscripts and superscripts are produced with the keywords sub and 
sup. Thus x sub j makes x i% a sub k sup 2 produces a/, while is 

made with e sup \x sup 2 + y sup 2\. Fractions are made with over: 

a over b yields sqrt makes square roots: 1 over sqrt jax sup 2+bx+c j 


results in . . — • 
vo**+6x +c 

The keywords from and to introduce lower and upper limits: J^E*< is 

made with limfrom \n -> inf J sum from 0 to n x sub i. Left and right 
brackets, braces, etc., of the right height are made with left and right: 


= l. 


left [ x sup 2 + y sup 2 over alpha right ] 1 produces 

Legal characters after left and right are braces, brackets, bars, c and f 




Page 1 


February 17, 1984 







EQN(l) 


MUNIX 


EQN(l) 


for ceiling and floor, and "" for nothing at all (useful for a right-side-only 
bracket). A left thing need not have a matching right thing. 

Vertical piles of things are made with pile, lpile, cpile. and rpile: 

pile | a above b above cj produces 6. Piles may have arbitrary numbers 

of elements; lpile left-justifies. pile and cpile center (but with different 
vertical spacing), and rpile right justifies. Matrices are made with matrix: 

matrix j LcoL { x sub i above y sub 2 j ccol { 1 above 2 j j produces 2 - 
In addition, there is rcol for a right-justified column. 

Diacritical marks are made with dot. dotdot, hat, tilde, bar, vec, dyad, 
and under: x dot = f(t) bar is i=/T*7. y dotdot bar ~=~ n under is y = n, 
and x vec y dyad is £ 

Point sizes and fonts can be changed with size n or size ±n. roman, italic, 
bold, and font n. Point sizes and fonts can be changed globally in a 
document by gsize n and gfont n, or by the command-line arguments 
—sn and —in. 

Normally, subscripts and superscripts are reduced by 3 points from the 
previous size; this may be changed by the command-line argument -pn. 

Successive display arguments can be lined up. Place mark before the 
desired lineup point in the first equation; place lineup at the place that is 
to line up vertically in subsequent equations. 

Shorthands may be defined or existing keywords redefined with define: 
define thing % replacement % 

defines a new token called thing that will be replaced by replacement 
whenever it appears thereafter. The 7 may be any character that does 
not occur in replacement. 

Keywords such as sum (£). int (/). inf (-). and shorthands such as >= (*). 
'= (*) and —> (-•) are recognized. Greek letters are spelled out in the 
desired case, as in alpha (a), or GAMMA (D- Mathematical words such as 
sin cos and log are made Roman automatically. Troff{ l) four-character 
escapes such as \(dd (t) and \ (bs (©may be used anywhere. Strings 
enclosed in double quotes ("...") are passed through untouched; this 
permits keywords to be entered as text, and can be used to communicate 
with troff(l) when all else fails. Full details are given in the manual cited 
below. 


Typesetting Mathematics—User's Guide by B. W. Kernighan and L. L. 
Cherry. 

New Graphic Symbols for EQN and NEQN by C. Scrocca. 
mm(l), mmt(l). tbl(l), troff (l). eqnchar(7). mm(7), mv(7). 

BUGS 

To embolden digits, parentheses, etc., it is necessary to quote them, as in 
bold "12.3". 

See also BUGS under trojf(l). 
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NAME 

error — analyze and disperse compiler error messages 
SYNOPSIS 

error [ -n ] [ —s J [ —q ] [ — -v ] [ — t suffixlist ] [ —I ignorefile ] [ 
name ] 

DESCRIPTION 

Error analyzes and optionally disperses the diagnostic error messages 
produced by a number of compilers and language processors to the 
source file and line where the errors occurred. It can replace the pain¬ 
ful. traditional methods of scribbling abbreviations of errors on paper, 
and permits error messages and source code to be viewed simultaneously 
without machinations of multiple windows in a screen editor. 

Error looks at the error messages, either from the specified file name or 
from the standard input, and attempts to determine which language pro¬ 
cessor produced each error message, determines the source file and line 
number to which the error message refers, determines if the error mes¬ 
sage is to be ignored or not, and inserts the (possibly slightly modified) 
error message into the source file as a comment on the line preceeding 
to which the line the error message refers. Error messages which can’t 
be categorized by language processor or content are not inserted into 
any file, but are sent to the standard output. Error touches source files 
only after all input has been read. By specifying the —q query option, the 
user is asked to confirm any potentially dangerous (such as touching a 
file) or verbose action. Otherwise error proceeds on its merry business. 
If the —t touch option and associated suffix list is given, error will restrict 
itself to touch only those files with suffices in the suffix list. Error also 
can be asked (by specifying —v) to invoke vi(l) on the files in which error 
messages were inserted; this obviates the need to remember the names 
of the files with errors. 

Error is intended to be run with its standard input connected via a pipe 
to the error message source. Some language processors put error mes¬ 
sages on their standard error file; others put their messages on the stan¬ 
dard output. Hence, both error sources should be piped together into 
error. For example, when using the csh syntax. 

make | & error —q —v 

or. for the Bourne shell, 

make 2>&1 | error —q —v 

will analyze all the error messages produced by whatever programs make 
runs. 

Error knows about the error messages produced by: make, cc, cpp, ccom, 
as, Id, lint, pi, pc and J77. Error knows a standard format for error mes¬ 
sages produced by the language processors, so is sensitive to changes in 
these formats. For all languages except Pascal, error messages are res¬ 
tricted to be on one line. Some error messages refer to more than one 
line in more than one files; error will duplicate the error message and 
insert it at all of the places referenced. 

Error will do one of six things with error messages. 
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synchronize 

Some language processors produce short errors describing 
which file it is processing. £Vror uses these to determine the file 
name for languages that don't include the file name in each 
error message. These synchronization messages are consumed 
entirely by error. 

discard Error messages from lint that refer to one of the two lint 
libraries, /usr/lib/llib-lc and /usr/lib/llib-port are discarded, 
to prevent accidently touching these libraries. Again, these 
error messages are consumed entirely by error. 

nullify Error messages from lint can be nullified if they refer to a 
specific function, which is known to generate diagnostics which 
are not interesting. Nullified error messages are not inserted 
into the source file, but are written to the standard output. The 
names of functions to ignore are taken from either the file 
named .errorrc in the users's home directory, or from the file 
named by the —I option. If the file does not exist, no error mes¬ 
sages are nullified. If the file does exist, there must be one 
function name per line. 

not file specific 

Error messages that can’t be intuited are grouped together, 
and written to the standard output before any files are 
touched. They will not be inserted into any source file. 

file specific 

Error message that refer to a specific file, but to no specific 
line, are written to the standard output when that file is 
touched. 

true errors 

Error messages that can be intuited are candidates for inser¬ 
tion into the file to which they refer. 

Only true error messages are candidates for inserting into the file they 
refer to. Other error messages are consumed entirely by error or are 
written to the standard output. Error inserts the error messages into 
the source file on the line preceeding the line the language processor 
found in error. Each error message is turned into a one line comment 
for the language, and is internally flagged with the string "###” at the 
beginning of the error, and ’*%%%” at the end of the error. This makes 
pattern searching for errors easier with an editor, and allows the mes¬ 
sages to be easily removed. In addition, each error message contains the 
source line number for the line the message refers to. A reasonably for¬ 
matted source program can be recompiled with the error messages still 
in it, without having the error messages themselves cause future errors. 
For poorly formatted source programs in free format languages, such as 
C or Pascal, it is possible to insert a comment into another comment, 
which can wreak havoc with a future compilation. To avoid this, format 
the source program so there are no language statements on the same 
line as the end of a comment. 

Options available with error are: 


February 17, 1984 


Page 2 





ERROR(i) 


llUNIX 


ERROR(1) 


-n Do not touch any files; all error messages are sent to the standard 
output. 

~q The user is queried whether s/he wants to touch the file. A "y" or 
“n" to the question is necessary to continue. Absence of the —q 
option implies that all referenced files (except those refering to dis¬ 
carded error messages) are to be touched. 

-v After all files have been touched, overlay the visual editor vi with it 
set up to edit all files touched, and positioned in the first touched 
file at the first error. If vi can’t be found, try ex or ed from standard 
places. 

-t Take the following argument as a suffix list. Files whose suffices do 
not appear in the suffix list are not touched. The suffix list is dot 
seperated, and wildcards work. Thus the suffix list: 

".c.y.foo*. h" 

allows error to touch files ending with ’*.c”, ”.y”, ”.foo*” and ’’.y". 

-s Print out statistics regarding the error categorization. Not too use¬ 
ful. 


Error catches interrupt and terminate signals, and if in the insertion 
phase, will orderly terminate what it is doing. 

AUTHOR 

Robert Henry 

FILES 

~/.errorrc function names to ignore for Lint error messages 

/dev/tty user's teletype 

BUGS 

Opens the teletype directly to do user querying. 

Source files with links make a new copy of the file with only one link to it. 

Changing a language processor’s format of error messages may cause 
error to not understand the error message. 

Error, since it is purely mechanical, will not filter out subsequent errors 
caused by floodgating’ initiated by one syntactically trivial error. 
Humans are still much better at discarding these related errors. 

Pascal error messages belong after the lines affected (error puts them 
before). The alignment of the *|’ marking the point of error is also dis¬ 
turbed by error. 

Error was designed for work on CRT’s at reasonably high speed. It is less 
pleasant on slow speed terminals, and has never been used on hardcopy 
terminals. 
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NAME 

ex — text editor 
SYNOPSIS 

ex [“][-▼][ “t <«£ ] [ ~t ] [ +command ] [ -1 ] [ -x ] name ... 
DESCRIPTION 

Ex is the root of a family of editors: ex and vi. Ex is a superset of ed, with 
the most notable extension being a display editing facility. Display based 
editing is the focus of vt. 

If you have a CRT terminal, you may wish to use a display based editor; in 
this case see vi(l), which is a command which focuses on the display 
editing portion of ex. 

DOCUMENTATION 

The Ex Reference Manual is a comprehensive and complete manual for 
the command mode features of ex, but you cannot learn to use the edi¬ 
tor by reading it. For an introduction to more advanced forms of editing 
using the command mode of ex see the editing documents written by 
Brian Kernighan for the editor ed; the material in the introductory and 
advanced documents works also with ex. 

An Introduction to Display Editing with Vi introduces the display editor 
vi and provides reference material on vi. The Vi Quick Reference card 
summarizes the commands of vi in a useful, functional way, and is useful 
with the Introduction. 

FOR ED USERS 

If you have used ed you will find that ex has a number of new features 
useful on CRT terminals. Intelligent terminals and high speed terminals 
are very pleasant to use with vi. Generally, the editor uses far more of 
the capabilities of terminals than ed does, and uses the terminal capabil¬ 
ity data base termcap{5) and the type of the terminal you are using from 
the variable TERM in the environment to determine how to drive your 
terminal efficiently. The editor makes use of features such as insert and 
delete character and line in its visual command (which can be abbrevi¬ 
ated vi) and which is the central mode of editing when using vt(l). There 
is also an interline editing open (o) command which works on all termi¬ 
nals. 

Ex contains a number of new features for easily viewing the text of the 
file. The z command gives easy access to windows of text. Hitting ~D 
causes the editor to scroll a half-window of text and is more useful for 
quickly stepping through a file than just hitting return. Of course, the 
screen oriented visual mode gives constant access to editing context. 

Ex gives you more help when you make mistakes. The undo (u) command 
allows you to reverse any single change which goes astray. Ex gives you 
a lot of feedback, normally printing changed lines, and indicates when 
more than a few lines are affected by a command so that it is easy to 
detect when a command has affected more lines than it should have. 

The editor also normally prevents overwriting existing files unless you 
edited them so that you don’t accidentally clobber with a write a file 
other than the one you are editing. If the system (or editor) crashes, or 
you accidentally hang up the phone, you can use the editor recover 
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command to retrieve your work. This will get you back to within a few 
lines of where you left off. 

Ex has several features for dealing with more than one file at a time. You 
can give it a list of files on the command line and use the next (n) com¬ 
mand to deal with each in turn. The next command can also be given a 
list of file names, or a pattern as used by the shell to specify a new set of 
files to be dealt with. In general, filenames in the editor may be formed 
with full shell metasyntax. The metacharacter is also available in 
forming filenames and is replaced by the name of the current file. 

For moving text between files and within a file the editor has a group of 
buffers, named a through z. You can place text in these named buffers 
and carry it over when you edit another file. 

There is a command & in ex which repeats the last substitute command. 
In addition there is a confirmed substitute command. You give a range of 
substitutions to be done and the editor interactively asks whether each 
substitution is desired. 

It is possible to ignore case of letters in searches and substitutions. Ex 
also allows regular expressions which match words to be constimcted. 
This is convenient, for example, in searching for the word "edit'’ if your 
document also contains the word editor. 

Ex has a set of options which you can set to tailor it to your liking. One 
option which is very useful is the autoindent option which allows the edi¬ 
tor to automatically supply leading white space to align text. You can 
then use the ~D key as a backtab and space and tab forward to align new 

code easily. 

Miscellaneous new useful features include an intelligent join (j) command 
which supplies white space between joined lines automatically, com¬ 
mands < and > which shift groups of lines, and the ability to filter por¬ 
tions of the buffer through commands such as sort. 

INVOCATION OPTIONS 

The following invocation options are interpreted by ex: 

Suppress all interactive-user feedback. This is useful in 
processing editor scripts. 

Invokes vi 

Edit the file containing the tag and position the editor at 
its definition. 

Recover file after an editor or system crash. If file is not 
specified a list of all saved files will be printed. 

Begin editing by executing the specified editor search or 
positioning command. 

LISP mode; indents appropriately for lisp code, the () {{ [[ 
and j] commands in vi and open are modified to have 
meaning for lisp . 

Encryption mode; a key is prompted for allowing creation 
or editing of an encrypted file. 


—v 

—Itag 
—r file 
+command 
-1 

—x 
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The name argument indicates files to be edited. 

Ex States 

Command Normal and initial state. Input prompted for by Your kill 
character cancels partial command. 

Insert Entered by a i and c. Arbitrary text may be entered. 

Insert is normaiiy terminated by line having only . on it! 
or abnormally with an interrupt. 

Open/visual Entered by open or vi, terminates with Q or ~\. 


Ex command names and abbreviarions 


abbrev 

ab 

next 

n 

unabbrev 

una 

append 

a 

number 

nu 

undo 

u 

args 

ar 

open 

o 

unmap 

unm 

change 

c 

preserve 

pre 

version 

ve 

copy 

CO 

print 

P 

visual 

vi 

delete 

d 

put 

pu 

write 

w 

edit 

e 

quit 

q 

xit 

X 

file 

f 

read 

re 

yank 

ya 

global 

g 

recover 

rec 

window 

z 

insert 

i 

rewind 

rew 

escape 

• 

join 

j 

set 

se 

Ishxft 

< 

list 

1 

shell 

sh 

print next 

CR 

map 


source 

so 

resubst 

tc 

mark 

ma 

stop 

St 

rshift 

> 

move 

m 

substitute 

s 

scroll 



£x Command 
n 

Addresses 
line n 

/pat 

next with pat 

• 

current 

?pat 

previous with pat 

S 

last 

x~n 

n before z 

+ 

next 

*.y 

z through y 

— 

previous 

' X 

marked with z 

+71 

n forward 

00 

previous context 

% 

l.S 




Initializing options 


EXINIT 

SHOME/.exrc 
./.exrc 
set z 
set noz 
set x=val 
set 

set all 
set z? 


place set’s here in environment var. 

editor initialization file 

editor initialization file 

enable option 

disable option 

give value val 

show changed options 

show all options 

show value of option z 


Useful options 

autoindent ai 

autowrite aw 

ignorecase ic 

lisp 

list 

magic 


supply indent 

write before changing files 

in scanning 

OH are s-exp's 

print -'I for tab, S at end 

. [ * special in patterns 
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number 

nu 

number lines 

paragraphs 

para 

macro names which start ... 

redraw 


simulate smart terminal 

scroll 


command mode lines 

sections 

sect 

macro names ... 

shiftwidth 

sw 

for < >, and input ~D 

showmatch 

sm 

to ) and j as typed 

slowopen 

slow 

stop updates during insert 

window 


visual mode lines 

wrapscan 

ws 

around end of buffer? 

wrapmargin 

wm 

automatic line splitting 


Scanning pattern formation 

~ beginning of line 

S end of line 

any character 

\ < beginning of word 

\ > end of word 

[sfr] any char in sir 

[tsfr] ... not in sfr 

[x—y] ... between x and y 

• any number of preceding 


AUTHOR 


Vi and ex are based on software developed by The Unviersity of Califor¬ 
nia, Berkeley California. Computer Science Division, Department of 
Electrical Engineering and Computer Science. 


FILES 

/usr/lib / ex?.?strings 

/ usr / lib / ex?.?rec over 

/usr/lib/ex?.?preserve 

/etc/termcap 

SHOME/.exrc 

./.exrc 

/ tmp / Exnnnnn 
/ tmp / Rxnnnnn 
/usr/preserve 


error messages 

recover command 

preserve command 

describes capabilities of terminals 

editor startup file 

editor startup file 

editor temporary 

named buffer temporary 

preservation directory 


SEE ALSO 

awk(l), ed(l), grep(l), sed(l), vi(l), termcap(5) 

CAVEATS AND BUGS 

The undo command causes all marks to be lost on lines changed and 
then restored if the marked lines were changed. 

Undo never clears the buffer modified condition. 

The 2 command prints a number of logical rather than physical lines. 
More than a screen full of output may result if long lines are present. 

File input/output errors don’t print a name if the command line * 
option is used. 

There is no easy way to do a single scan ignoring case. 

The editor does not warn if text is placed in named buffers and not used 
before exiting the editor. 
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Null characters are discarded in input files, and cannot 
tant files. 


appear in resul- 
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NAME 

excr ~ run a program on another system 
SYNOPSIS 

excr system program arg ... 

DESCRIPTION 

If the program name begins with a V then the program with that name 
on the named system will be run. However, if there is no V then the 
directories '’/bin" and then "/usr/bin" on the named system are 
searched for the program. When it is found, the program is executed as 
though its root were on the named file system. If the normal "exec'' 

returns errno - ENOEXEC. an attempt is made to execute the shell on the 
named file. 


This provides the user with a different facility to the one provided by 
remote execution. Thus the command "/../U5/bin/who" issued on sys- 
tem U1 win print out a list of the users on Ul; to obtain a list of the users 
on U5 the excr command must be used - "excr /../U5 who". 

DIAGNOSTICS 

An error message is printed if the program does not exist or cannot be 
executed. 

FILES 

/usr/NCbin/excr 


Page 1 


February 17, 1984 









EXPAND(1) 


MUNIX 


EXPAND(l) 


NAME 

expand, unexpand - expand tabs to spaces, and vice versa 
SYNOPSIS 

expand [ -tabstop ] [ -tabl,tab2.tabn ] [ file ... ] 

unexpand [ -a ] [ file ... ] 

DESCRIPTION 

Expand processes the named files or the standard input writing the stan¬ 
dard output with tabs changed into blanks. Backspace characters are 
preserved into the output and decrement the column count for tab cal¬ 
culations. Expand is useful for pre-processing character files (before 
sorting, looking at specific columns, etc.) that contain tabs. 

If a single tabstop argument is given then tabs are set tabstop spaces 
apart instead of the default 8. If multiple tabstops are given then the 
tabs are set at those specific columns. 

Unexpand puts tabs back into the data from the standard input or the 
named files and writes the result on the standard output. By default only 
leading blanks and tabs are reconverted to maximal strings of tabs. If 
the -a option is given, then tabs are inserted whenever they would 
compress the resultant file by replacing two or more characters. 
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NAME 

expr — evaluate arguments as an expression 

SYNOPSIS 

expr arg ... 

DESCRIPTION 

The arguments are taken as an expression. After evaluation, the result is 
written on the standard output. Each token of the expression is a 
separate argument. 

The operators and keywords are listed below. The list is in order of 
increasing precedence, with equal precedence operators grouped. 

expr | expr 

yields the first expr if it is neither null nor ‘O', otherwise yields the 
second expr. 

expr Sc expr 

yields the first expr if neither expr is null or 'O’, otherwise yields 
•O’. 

expr relop expr 

where relop is one of < <= = != >= >, yields T if the indicated 
comparison is true, ’0’ if false. The comparison is numeric if both 
expr are integers, otherwise lexicographic. 

expr + expr 

expr - expr 

addition or subtraction of the arguments. 

expr * expr 

expr / expr 
expr % expr 

multiplication, division, or remainder of the arguments. 
expr : expr 

The matching operator compares the string first argument with 
the regular expression second argument; regular expression syn¬ 
tax is the same as that of ed(l). The \(...\) pattern symbols can 
be used to select a portion of the first argument. Otherwise, the 
matching operator yields the number of characters matched (‘0’ 
on failure). 

( expr ) 

parentheses for grouping. 

Examples: 

To add 1 to the Shell variable a: 
a='expr $a + 1' 

To find the filename part (least significant part) of the pathname stored 
in variable a, which may or may not contain 

expr Sa : '.*/\(.*\)' '|' Sa 
Note the quoted Shell metacharacters. 

SEE ALSO 

ed(l), sh(l), test(l) 
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DIAGNOSTICS 

Expr returns the following exit codes: 

0 if the expression is neither null nor ‘O'. 

1 if the expression is null or ’O’, 

2 for invalid expressions. 
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NAME 

f77 — Fortran 77 compiler 
SYNOPSIS 

f77 [ option ] ... file ... 

DESCRIPTION 

F77 is the UNIX Fortran 77 compiler. It accepts several types of argu¬ 
ments: 

Arguments whose names end with \f* are taken to be Fortran 77 source 
programs; they are compiled and linked. Each object program is left on 
the file in the current directory whose name is that of the source with \o’ 
substituted for ’.f’; the executable file is left on ‘a.out’. 

Arguments whose names end with *.r’ or \e' are taken to be Ratfor or EFL 
source programs, respectively; these are first transformed by the 
appropriate preprocessor, then compiled by/77. 

In the same way, arguments whose names end with \c* or ‘.s’ are taken to 
be C or assembly source programs and are compiled or assembled and 
linked. 

Floating point is available in three different versions. The options are the 
same as in cc(l) and the description in/p(3) applies. When the Motorola 
Fast Floating Point Package is used, the compiler accepts double preci¬ 
sion declarations, but handles them silently as single precision. 

The following options have a similar meaning as in cc(l): 

—c Suppress the linking phase. 

—p Prepare object files for profiling, see j>ro/(l). 

—S Compile the named programs without linking, and leave the 

assembler-listing on corresponding files suffixed '.s’. 

—o output 

Name the final output file output instead of ‘a.out’. 

-am 

Use Motorola Fast Floating Point (-f; default), use Motorola IEEE 
Floating Point Software (-fF), use FPP board with NSC 16081 pro¬ 
cessor (-fN). 

—K n n is a number in C notation (e.g. 4096 or 0x1000 or 010000), which 
determines the stack size of the generated program (default 2048 
bytes, cf. stksiz(l)). 

The following options are peculiar to /77: 

—onetrip 

Compile DO loops that are performed at least once if reached. 
(Fortran 77 DO loops are not performed at all if the upper limit is 
smaller than the lower limit.) 

—1 Same as ’-onetrip’. 

—U Do not convert UPPERCASE to lowercase. 

—u Make the default type of a variable ’undefined’ rather than using 

the default Fortran rules. 
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-C Compile code to check that subscripts are within declared array 
bounds. 

—w Suppress all warning messages. If the option is w66', only For¬ 

tran 66 compatibility warnings are suppressed. 

—Nz Change default sizes of certain tables, ’x’ is one of the letters 
q.x.s.c or n followed directly by a decimal number. The defaults 
are: 

-Nql 50 Maximum number of equivalence statements 
-Nx200 Maximum number of external definitions 
-Ns701 Maximum number of statement labels 
-Nc20 Maximum nesting of control structures 

-Nn401 Size of hash table 

-12 Use short integers (2 bytes) for Fortran type integer. 

-14 Use long integers (4 bytes) for Fortran type integer (default). 

—Is Make subscripts short (default). 

-n Make subscripts long. This option must be given if an array or a 
common block is larger than 32 K bytes. It is possible to link sub¬ 
programs compiled with -Is and -II. 

-F Apply EFL and Ratfor preprocessor to relevant files, put the result 
in the file with the suffix changed to \f’, but do not compile. 

—m Apply the M4 preprocessor to each ‘.r’ or ‘.e’ file before transform¬ 

ing it with the Ratfor or EFL preprocessor. 

—Ez Use the string z as an EFL option in processing \e’ files. 

-Rz Use the string z as a Ratfor option in processing ’.r' files. 

Other arguments are taken to be either linker option arguments, or 
F77-compatible object programs, typically produced by an earlier run. or 
perhaps libraries of F77-compatible routines. These programs, together 
with the results of any compilations specified, are linked (in the order 
given) to produce an executable program with name ‘a.out’. 


FILES 

file.[fresc] 

file.o 

a.out 

/usr/lib/f77passlffp 

/usr/lib/f77passlieee 

/lib/cl 

/lib/c2 

/usr/lib/libF77ffp.a 
/usr/lib/libF77mot.a 
/usr/lib/libF77nsc.a 
/usr /lib/lib!77*.a 
/lib/libfTp.a 
/lib/libmot.a 
/lib/libnsc.a 
/lib/libc.a 


input file 

object file 

linked output 

compiler pass for FFP 

compiler pass for IEEE floating point 

pass 2 

pass3 

intrinsic function library FFP 
intrinsic function library Motorola IEEE 
intrinsic function library NSC IEEE 
Fortran I/O library also for flp, mot. nsc 
Floating point library FFP 
Floating point library Motorola IEEE 
Floating point library NSC IEEE 
C library, see section 3 


SEE ALSO 
S. 1. 


Feldman. P. J. Weinberger. A Portable Fortran 77 Compiler 
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cc( 1), Id(1). prof(l) 

DIAGNOSTICS 

The diagnostics produced by J77 itself are intended to be self- 
explanatory. Occasional messages may be produced by the linker. 

BUGS 

This compiler has run the Fortran Compiler Validation Suite FCVS 78 
from the Federal Cobol Compiler Test Service (FCCTS). FCVS 70 is also 
known as ''navytest". It passed all tests except two. One error is due to 
floating point accuracy. The other error is that a format statement must 
be given before an ’'assign”-statement that assigns the label of the for¬ 
mat statement to an integer variable. 

If a common block is defined in one source file and incompletely initial 1 
ized in another one. the block is without warning truncated to the initial¬ 
ized size. 
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NAME 

factor — factor a number 

SYNOPSIS 

factor [ number ] 

DESCRIPTION 

When factor is invoked without an argument, it waits for a number to be 
typed in. If you type in a positive number less than 2 M (about 7.2xi 0 ia ) it 
will factor the number and print its prime factors; each one is printed 
the proper number of times. Then it waits for another number. It exits if 
it encounters a zero or any non-numeric character. 

If factor is invoked with an argument, it factors the number as above and 
then exits. 

Maximum time to factor is proportional to Vn and occurs when n is 
prime or the square of a prime. It takes 1 minute to factor a prime near 
10 u on a PDP-11. 

DIAGNOSTICS 

“Ouch" for input out of range or for garbage input. 
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NAME 

file — determine file type 

SYNOPSIS 

file file ... 

DESCRIPTION 

File performs a series of tests on each argument in an attempt to classify 
it. If an argument appears to be ascii, file examines the first 512 bytes 
and tries to guess its language. 

BUGS 

It often makes mistakes. In particular it often suggests that command 
files are C programs. 
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NAME 

find — find files 
SYNOPSIS 

find [ —1 maxlvl ] path*name-list expression 
DESCRIPTION 

Find recursively descends the directory hierarchy for each path name in 
the path-name-list (i.e., one or more path names) seeking files that 
match a boolean expression written in the primaries given below. If —1 
maxlvl is specified, the directory walk will be at most maxlvl levels deep. 
In the descriptions, the argument n is used as a decimal integer where 
+n means more than n, —n means less than n and n means exactly n. 


—name file 

True if file matches the current file name. Normal shell 
argument syntax may be used if escaped (watch out for [, 
? and •). 

—perm onum 

True if the file permission flags exactly match the octal 
number onum (see c/imod(l)). If onum is prefixed by a 
minus sign, more flag bits (017777, see stat(2)) become 
significant and the flags are compared: 

(fiags&onum)==onum 

—type c 

True if the type of the file is c, where c is b, c, d, p, or f for 
block special file, character special file, directory, fifo 
(a.k.a named pipe), or plain file. 

—links n 

True if the file has n links. 


—user uname True if the file belongs to the user uname . If uname is 
numeric and does not appear as a login name in the 
/etc/passnrd file, it is taken as a user ID. 

—group gname 

True if the file belongs to the group gname. If gname is 


—size n 

—a time n 

—mtime n 

—ctime n 

—exec cmd 

numeric and does not appear in the /etc/group file, it is 
taken as a group ID. 

True if the file is n blocks long (512 bytes per block). 

True if the file has been accessed in n days. 

True if the file has been modified in n days. 

True if the file has been changed in n days. 

True if the executed cmd returns a zero value as exit 
status. The end of cmd must be punctuated by an 
escaped semicolon. A command argument \\ is replaced 
by the current path name. 

—ok cmd 

Like —exec except that the generated command line is 
printed with a question mark first, and is executed only if 
the user responds by typing y. 

—print 
—cpio device 

Always true; causes the current path name to be printed. 

Write the current file on device in cpio (5) format (5120 
byte records). 
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-newer file True if the current file has been modified more recently 
J than the argument file. 

( expression ) True if the parenthesized expression is true (parentheses 
V ^ are special to the shell and must be escaped). 

The primaries may be combined using the following operators (in order of 
decreasing precedence): 

1) The negation of a primary (! is the unary not operator). 

2) Concatenation of primaries (the and operation is implied by the jux- 
taposition of two primaries). 

3) Alternation of primaries (-o is the or operator). 

EXAMP T= remove ell files named a.out or ..o that have not been accessed for a 
week: 


FILES 


find / \( -name a.out -o -name '..o' \) -atime +7 -exec rm || \: 
/etc/passwd, /etc/group 


SEE AL cpio(l). sh(l). test(l). stat(2). cpto(S). fs(5). 
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NAME 

finger - user information lookup program 
SYNOPSIS 

finger [ options ] name ... 

DESCRIPTION 

By default finger lists the login name, full name, terminal name and write 
status (as a *•’ before the terminal name if write permission is denied), 
idle time, login time, and office location and phone number (if they are 
known) for each current UNIX user. (Idle time is minutes if it is a single 
integer, hours and minutes if a is present, or days and hours if a 'd' is 
present.) 

A longer format also exists and is used by finger whenever a list of peo¬ 
ples names is given. (Account names as well as first and last names of 
users are accepted.) This format is multi-line, and includes all the infor¬ 
mation described above as well as the user's home directory and login 
shell, any plan which the person has placed in the file .plan in their home 
directory, and the project on which they are working from the file pro¬ 
ject also in the home directory. 

Finger options include: 

—m Match arguments only on user name. 

—1 Force long output format. 

—p Suppress printing of the plan files 

—s Force short output format. 

FILES 

/etc/utmp 
/etc/passwd 
/usr/adm/lastlog 
~/.plan 
~/. project 

SEE ALSO 

w(l), who(l) 

AUTHOR 

Earl T. Cohen 

BUGS 

Only the first line of the project file is printed. 

The encoding of the geos field is UCB dependent — it knows that an office 
*197MC' is ‘197M Cory Hall', and that '529BE' is '529B Evans Hall'. 

A user information data base is in the works and will radically alter the 
way the information that finger uses is stored. Finger will require exten¬ 
sive modification when this is implemented. 


who file 

for users names, offices, ... 

last login times 

plans 

projects 
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NAME 

fmt - simple text formatter 

SYNOPSIS 

fmt [ name ... ] 

DESCRIPTION 

Fmt is a simple text formatter which reads the concatenation of input 
files (or standard input if none are given) and produces on standard out¬ 
put a version of its input with lines as close to 72 characters long as pos¬ 
sible. The spacing at the beginning of the input lines is preserved in the 
output, as are blank lines and interword spacing. 

Fmt is meant to format mail messages prior to sending, but may also be 
useful for other simple tasks. For instance, within visual mode of the ex 
editor (e.g. vi) the command 
!jfmt 

will reformat a paragraph, evening the lines. 

SEE ALSO 

nroff(l), mail(l) 

AUTHOR 

Kurt Shoens 

BUGS 

The program was designed to be simple and fast for more complex 
operations, the standard text processors are likely to be more appropri¬ 
ate. 
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NAME 

fold - fold long lines for finite width output device 
SYNOPSIS 

fold [ -width ] [ file ... ] 

DESCRIPTION 

Fold is a filter which will fold the contents of the specified files, or the 
standard input if no files are specified, breaking the lines to have max¬ 
imum width width. The default for width is 80. Width should be a multi¬ 
ple of 8 if tabs are present, or the tabs should be expanded using 
expand{l) before coming to fold. 

SEE ALSO 

expand(l) 

BUGS 

If underlining is present it may be messed up by folding. 
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NAME 

fpr — printer filter for FORTRAN output 

SYNOPSIS 

fpr [ file ... ] 

DESCRIPTION 

Fpr is a printer filter for output of FORTRAN programs. The first charac¬ 
ter of each line is interpreted as a format control character. The follow¬ 
ing characters are recognized: 

<space> 

single line feed, 

1 form feed, 

0 double line feed, 

+ no line feed, i.e. print over previous line. 

Other characters are treated like a space, i.e. single line feed, also are 
totally empty lines. 

Input is read from the files given as arguments or from standard input, a 
file name of - is also interpreted as standard input. 

Output is written to standard output. 

EXAMPLE 

The command line 
a.out | fpr | lpr 

prints the output to channel 6 of the FORTRAN program a.out with for¬ 
mat control on the line printer. 

BUGS 

It is not possible to print more than 66 lines per page due to lpr setting. 
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NAME 

from — who is my mail from? 

SYNOPSIS 

from [ —s sender ] [ user ] 

DESCRIPTION 

From prints out the mail header lines in your mailbox file to show you 
who your mail is from. If user is specified, then user’s mailbox is exam¬ 
ined instead of your own. If the -s option is given, then only headers for 
mail sent by sender are printed. 

FILES 

/usr/mail/* 

SEE ALSO 

mail(l), prmail(l) 
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NAME 

get — get a version of an SCCS file 
SYNOPSIS 

get [-rSID] [-ccutoff] [—ilist] [-xlist] [—aseq-no.] [—k] [-e] [-l[p]] 
[-p] [~ra] [-n] [—s] [-b] [-g] [-t] file ... 

DESCRIPTION 

Get generates an ASCII text file from each named SCCS file according to 
the specifications given by its keyletter arguments, which begin with —. 
The arguments may be specified in any order, but all keyletter argu¬ 
ments apply to all named SCCS files. If a directory is named, get behaves 
as though each file in the directory were specified as a named file, except 
that non-SCCS files (last component of the path name does not begin with 
s.) and unreadable files are silently ignored. If a name of — is given, the 
standard input is read; each line of the standard input is taken to be the 
name of an SCCS file to be processed. Again, non-SCCS files and unread¬ 
able files are silently ignored. 

The generated text is normally written into a file called the g-file whose 
name is derived frqm the SCCS file name by simply removing the leading 
s.; (see also FILES, below). 

Each of the keyletter arguments is explained below as though only one 
SCCS file is to be processed, but the effects of any keyletter argument 
applies independently to each named file. 

—rSID The SCCS /identification string (SID) of the version (delta) of an 
SCCS file to be retrieved. Table 1 below shows, for the most 
useful cases, what version of an SCCS file is retrieved (as well 
as the SID of the version to be eventually created by delta(l) if 
the —e keyletter is also used), as a function of the SID 
specified. 

—ccutoff Cutoff date-time, in the form: 

YY[MM[DD[HH[MM[SS]]]]] 

No changes (deltas) to the SCCS file which were created after 
the specified cutoff date-time are included in the generated 
ASCII text file. Units omitted from the date-time default to 
their maximum possible values; that is, —c7502 is equivalent to 
—c750228235959. Any number of non-numeric characters 
may separate the various 2 digit pieces of the cutoff date-time. 
This feature allows one to specify a cutoff date in the form: 

c77/2/2 9:22:25”. Note that this implies that one may use 
the %E% and %U 7, identification keywords (see below) for 
nested gets within, say the input to a send( 1C) command: 

~!get c%E% %U%" s.file 

—e Indicates that the get is for the purpose of editing or making a 

change (delta) to the SCCS file via a subsequent use of 
delta(l). The —e keyletter used in a get for a particular ver¬ 
sion (SID) of the SCCS file prevents further gets for editing on 
the same SID until delta is executed or the j (joint edit) flag is 
set in the SCCS file (see adTntn(l)). Concurrent use of get —e 
for different SIDs is always allowed. 
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-b 


—i list 


—xlist 


-k 


-Up] 


-p 


—m 


—n 


If the g-file generated by get with an -e keyletter is acciden¬ 
tally ruined in the process of editing it. it may be regenerated 
by re-executing the get command with the —k keyletter in 
place of the -e keyletter. 

SCCS file protection specified via the ceiling, floor, and author¬ 
ized user list stored in the SCCS file (see admtn(l)) are 
enforced when the -e keyletter is used. 

Used with the —e keyletter to indicate that the new delta 
should have an SID in a new branch as shown in Table 1. This 
keyletter is ignored if the b flag is not present in the file (see 
admin( 1)) or if the retrieved delta is not a leaf delta. (A leaf 
delta is one that has no successors on the SCCS file tree .) 

Note: A branch delta may always be created from a non-leaf 

delta. 

A list of deltas to be included (forced to be applied) in the 
creation of the generated file. The list has the following syn¬ 
tax: 

<list> ::= <range> | <list> , <range> 

<range> ::= SID | SID — SID 

SID the SCCS Identification of a delta, may be in any form 
shown in the "SID Specified” column of Table 1. Partial SIDs 
are interpreted as shown in the "SID Retrieved” column of 
Table 1. 

A list of deltas to be excluded (forced not to be applied) in the 
creation of the generated file. See the -i keyletter for the list 

format. 

Suppresses replacement of identification keywords (see below) 
in the retrieved text by their value. The -k keyletter is 
implied by the —e keyletter. 

Causes a delta summary to be written into an l-file. If —lp is 
used then an l-file is not created: the delta summary is writ¬ 
ten on the standard output instead. See FILES for the format 
of the l-file. 

Causes the text retrieved from the SCCS file to be written on 
the standard output. No g-file is created. All output which 
normally goes to the standard output goes to file descriptor d 
instead, unless the -s keyletter is used, in which case it disap¬ 


pears. 

Suppresses all output normally written on the standard out¬ 
put. However, fatal error messages (which always go to file 
descriptor 2) remain unaffected. 

Causes each text line retrieved from the SCCS file to be pre¬ 
ceded by the SID of the delta that inserted the text line in the 
SCCS file. The format is: SID. followed by a horizontal tab, fol¬ 
lowed by the text line. 


Causes each generated text line to be preceded with the 
identification keyword value (see below). The format is. 


%M% 

%M% 
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value, followed by a horizontal tab, followed by the text line. 
When both the —m and —n keyletters are used, the format is: 
%M% value, followed by a horizontal tab, followed by the —m 
keyletter generated format. 

—g Suppresses the actual retrieval of text from the SCCS file. It is 

primarily used to generate an l-file, or to verify the existence 
of a particular SID. 

—t Used to access the most recently created ("top”) delta in a 

given release (e.g., —rl), or release and level (e.g., —rl.2). 

—a seq-no. The delta sequence number of the SCCS file delta (version) to 
be retrieved (see sccsfile( 5)). This keyletter is used by the 
comb(l) command; it is not a generally useful keyletter, and 
users should not use it. If both the —r and —a keyletters are 
specified, the —a keyletter is used. Care should be taken when 
using the —a keyletter in conjunction with the —e keyletter, as 
the SID of the delta to be created may not be what one 
expects. The —r keyletter can be used with the —a and —e 
keyletters to control the naming of the SID of the delta to be 
created. 

For each file processed, get responds (on the standard output) with the 
SID being accessed and with the number of lines retrieved from the SCCS 
file. 

If the —e keyletter is used, the SID of the delta to be made appears after 
the SID accessed and before the number of lines generated. If there is 
more than one named file or if a directory or standard input is named, 
each file name is printed (preceded by a new-line) before it is processed. 
If the —i keyletter is used included deltas are listed following the nota¬ 
tion •'Included”; if the —x keyletter is used, excluded deltas are listed fol¬ 
lowing the notation "Excluded”. 


TABLE 1. Determination of SCCS Identification String 


SID* 

Specified 

—b Keyletter 
Usedt 

Other 

Conditions 

SID 

Retrieved 

SID of Delta 
to be Created 

nonet 

no 

R defaults to mR 

mR.mL 

mR.(mL + l) 

nonet 

yes 

R defaults to mR 

mR.mL 

mR.mL.(mB + l).l 

R 

no 

R > mR 

mR.mL 

R.l*** 

R 

no 

R = mR 

mR.mL 

mR.(mL+l) 

R 

yes 

R > mR 

mR.mL 

mR.mL. (mB + 1). 1 

R 

yes 

R = mR 

mR.mL 

mR.mL.(mB + l).l 

R 

— 

R < mR and 

R does no* exist 

hR.mL** 

hR.mL. (mB + l).l 

R 

— 

Trunk succ.# 
in release > R 
and R exists 

R.mL 

R.mL.(mB + l).l 

R.L 

no 

No trunk succ. 

R.L 

R.(L+1) 

R.L 

yes 

No trunk succ. 

R.L 

R.L.(mB + l). 1 

R.L 

— 

Trunk succ. 
in release ^ R 

R.L 

R.L.(mB + l).l 
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R.L.B 


no 


No branch succ.R.L.B.mS R.L.B.(mS + 1) 


R.L.B 


res 


No branch succ.R.L.B.mS R.L.(mB + l)j l 


R.L.B.S 


no 


No branch succ. 


R.L.B.S 


R.L.B.(S + l) 

R.L.(mB + l).l 


R.L.B.S 


res 


No branch succ. 


R.L.B.S 


R.L.B.S 


Branch succ. 


R.L.B.S 


R.L.(mB + l).l 


••R- "L”. "B", and "S" are the -release”, "level”, "branch”, and 
••sequence” components of the SID. respectively; ”m" means "max¬ 
imum''. Thus, for example. "R.mL" means "the maximum level 
number within release R”; "R.L.(mB+l).l" means "the first sequence 
number on the new branch (i.e., maximum branch number plus one) 
of level L within release R". Note that if the SID specified is of the 
form "R.L", "R.L.B". or "R.L.B.S". each of the specified components 

must exist. . _ , 

"hR" is the highest existing release that is lower than the specified. 

nonexistent, release R. 

This is used to force creation of the first delta in a new release. 
Successor 

The -b keyletter is effective only if the b flag (see admin (1)) is 
present in the file. An entry of - means "irrelevant”. 

+ This case applies if the d (default SID) flag is not present in the file 
If the d flag is present in the file, then the SID obtained from the d 
flag is interpreted as if it had been specified on the command line. 
Thus, one of the other cases in this table applies. 

IDENTIFICATION KEYWORDS . , 9rrs 

Identifying information is inserted into the text retrieved from the SCCS 
file by replacing identification keywords with their value wherever they 
occur. The following keywords may be used in the text stored in an SCCS 

file: 


** 


♦ ** 

# 

t 


Keyword 

7.U7. 


7.17. 

%R% 

7.L7. 

7.B7. 

7.S7. 

7.D7. 

7.H7. 

7.T7. 

7.E7. 

7.G7. 

7.U7. 

7.Y7. 

7.F7. 

7.P7. 

%Q% 


YLLLU, IS , , / 

Module name: either the value of the m flag in the file (see 
admin(l)). or if absent, the name of the SCCS file with the lead¬ 
ing s. removed. . ^ , . , 

SCCS identification (SID) (%R%.%L%.%B%.%S%) of the retrieved 

text. 

Release. 

Level. 

Branch. 

Sequence. 

Current date (YY/MM/DD). 

Current date (MM/DD/YY). 

Current time (HH:MM:SS). 

Date newest applied delta was created (YY/MM/DD). 

Date newest applied delta was created (MM/DD/YY). 

Time newest applied delta was created (HH:MM:SS). 

Module type: value of the t flag in the SCCS file (see admin(l)). 
SCCS file name. 

Fully qualified SCCS file name. 

The value of the q flag in the file (see admm(l)). 
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%C% Current line number. This keyword is intended for identifying 

messages output by the program such as "this shouldn't have 
happened" type errors. It is not intended to be used on every 
line to provide sequence numbers. 

%ZX The 4-character string @(#) recognizable by u)A.af(l). 

XWZ A shorthand notation for constructing ti>Aaf(l) strings for UNIX 
program files. %W% = %Z/5%M%<horizontal-tab>%I% 

5SA% Another shorthand notation for constructing what(l) strings 

for non-UNIX program files. %A% = %Z%%Y% %M% %I%%Z% 


FILES 

Several auxiliary files may be created by get, These files are known 
generically as the g-file, l-file, p-file, and z-file. The letter before the 
hyphen is called the tag. An auxiliary file name is formed from the SCCS 
file name: the last component of all SCCS file names must be of the form 
s.module-name, the auxiliary files are named by replacing the leading s 
with the tag. The g-file is an exception to this scheme: the g-file is 
named by removing the s. prefix. For example, s.xyzx, the auxiliary file 
names would be xyz.c, l.xyz.c, p.xyz.c, and z.xyz.c, respectively. 

The g-file, which contains the generated text, is created in the current 
directory (unless the —p keyletter is used). A g-file is created in all 
cases, whether or not any lines of text were generated by the get. It is 
owned by the real user. If the —k keyletter is used or implied its mode is 
644; otherwise its mode is 444. Only the real user need have write per¬ 
mission in the current directory. 


The l-file contains a table showing which deltas were applied in generat¬ 
ing the retrieved text. The l-file is created in the current directory if the 
—1 keyletter is used; its mode is 444 and it is owned by the real user. Only 
the real user need have write permission in the current directory. 


Lines in the l-file have the following format: 

a. A blank character if the delta was applied; 

• otherwise. 

b. A blank character if the delta was applied or wasn't applied 
and ignored; 

• if the delta wasn't applied and wasn't ignored. 

c. A code indicating a “special" reason why the delta was or 
was not applied: 

"I": Included. 

“X": Excluded. 

"C": Cut off (by a —c keyletter). 

d. Blank. 

e. SCCS identification (SID). 

f. Tab character. 

g Date and time (in the form YY/MM/DD HH:MM:SS) of creation. 

h. Blank. 

i. Login name of person who created delta. 

The comments and MR data follow on subsequent lines, indented 
one horizontal tab character. A blank line terminates'each entry. 


The p-file is used to pass information resulting from a get with an —e 
keyletter along to delta. Its contents are also used to prevent a 
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subsequent execution of get with an —e keyletter for the same SID until 
delta is executed or the joint edit flag. j. (see admin(l)) is set in the SCCS 
file. The p-file is created in the directory containing the SCCS file and 
the effective user must have write permission in that directory. Its mode 
is 644 and it is owned by the effective user. The format of the p-file is: 
the gotten SID. followed by a blank, followed by the SID that the new delta 
will have when it is made, followed by a blank, followed by the login name 
of the real user, followed by a blank, followed by the date-time the get 
was executed, followed by a blank and the -i keyletter argument if it was 
present, followed by a blank and the -x keyletter argument if it was 
present, followed by a new-line. There can be an arbitrary number of 
lines in the p-file at any time; no two lines can have the same new delta 
SID. 

The z-file serves as a lock-out mechanism against simultaneous updates. 
Its contents are the binary (2 bytes) process ID of the command (i.e., get) 
that created it. The z-file is created in the directory containing the SCCS 
file for the duration of get. The same protection restrictions as those for 
the p-file apply for the z-file. The z-file is created mode 444. 

SEE ALSO 

admin(l), delta(l), help(l), prs(l), what(l), sccsfile(5). 

Source Code Control System User's Guide by L. E. Bonanni and C. A. 
Salemi. 

DIAGNOSTICS 

Use h.elp(l) for explanations. 

BUGS , , 

If the effective user has write permission (either explicitly or implicitly) 
in the directory containing the SCCS files, but the real user doesn’t, then 
only one file may be named when the —e keyletter is used. 
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NAME 

getopt — parse command options 
SYNOPSIS 

set — 'getopt optstring 8*' 

DESCRIPTION 

Getopt is used to break up options in command lines for easy parsing by 
shell procedures, and to check for legal options. Optstring is a string of 
recognized option letters (see getopt(3C)); if a letter is followed by a 
colon, the option is expected to have an argument which may or may not 
be separated from it by white space. The special option — is used to 
delimit the end of the options. Getopt will place — in the arguments at 
the end of the options, or recognize it if used explicitly. The shell argu¬ 
ments (81 82 . . .) are reset so that each option is preceded by a — and in 
its own shell argument; each option argument is also in its own shell 
argument. 

DIAGNOSTICS 

Getopt prints an error message on the standard error when it encounters 
an option letter not included in optstring. 

EXAMPLE 

The following code fragment shows how one might process the arguments 
for a command that can take the options a and b, and the option o, 
which requires an argument. 

set — 'getopt abo: 8*' 

if [ 8? != 0 ] 

then 

echo SUSAGE 
exit 2 
fi 

for i in 8* 
do 

case Si in 

—a | —b) FLAG=8i; shift;; 

—o) 0ARG=S2; shift; shift;; 

—) shift; break;; 

esac 

done 

This code will accept any of the following as equivalent: 

cmd —aoarg file file 
cmd —a —o arg file file 
cmd —oarg —a file file 
cmd —a —oarg — file file 

SEE ALSO 

sh(l), getopt(3C). 
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NAME 

graph - draw a graph 


SYNOPSIS 

graph [ options ] 

DESCRIPTION 

Graph with no options takes pairs of numbers from the standard input as 
abscissas and ordinates of a graph. Successive points are connected by 
straight lines. The graph is encoded on the standard output for display 
by the tplot(lG) filters. 

If the coordinates of a point are followed by a non-numeric string, that 
string is printed as a label beginning on the point. Labels may be sur¬ 
rounded with quotes ", in which case they may be empty or contain 
blanks and numbers; labels never contain new-lines. 

The following options are recognized, each as a separate argument: 


—a 




-y [ 1 3 

-h 


—r 


Supply abscissas automatically (they are missing from the 
input); spacing is given by the next argument (default 1). A 
second optional argument is the starting point for automatic 
abscissas (default 0 or lower limit given by —x). 

Break (disconnect) the graph after each label in the input. 
Character string given by next argument is default label for 
each point. 

Next argument is grid style, 0 no grid, 1 frame with ticks, 2 full 
grid (default). 

Next argument is label for graph. 

Next argument is mode (style) of connecting lines: 0 discon¬ 
nected, 1 connected (default). Some devices give distinguish¬ 
able line styles for other small integers (e.g., the Tektronix 
4014: 2=dotted, 3=dash-dot, 4=short-dash, 5=long-dash). 

Save screen, don’t erase before plotting. 

If 1 is present, x axis is logarithmic. Next 1 (or 2) arguments are 
lower (and upper) x limits. Third argument, if present, is grid 
spacing on x axis. Normally these quantities are determined 
automatically. 

Similarly for y. 

Next argument is fraction of space for height. 

Similarly for width. 

Next argument is fraction of space to move right before plot¬ 


ting. 

—u Similarly to move up before plotting. 

—t Transpose horizontal and vertical axes. (Option —x now applies 

to the vertical axis.) 

A legend indicating grid range is produced with a grid unless the —s 
option is present. If a specified lower limit exceeds the upper limit, the 
axis is reversed. 


SEE ALSO 

graphics(lG), spline(lG), tplot(lG). 

BUGS 

Graph stores all points internally and drops those for which there isn't 
room. 
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Segments that run out of bounds are dropped, not windowed. 
Logarithmic axes may not be reversed. 


February 17. 1984 


Page 2 




GREP(l) 


MUNIX 


GREP(l) 


NAME 

grep. egrep, fgrep — search a file for a pattern 
SYNOPSIS 

grep [ options ] expression [ files ] 
egrep [ options ] [ expression ] [ files ] 
fgrep [ options ] [ strings ] [ files ] 

DESCRIPTION 

Commands of the grep family search the input files (standard input 
default) for lines matching a pattern. Normally, each line found is copied 
to the standard output. Grep patterns are limited regular expressions in 
the style of ecf(l); it uses a compact non-deterministic algorithm. Egrep 
patterns are full regular expressions', it uses a fast deterministic algo¬ 
rithm that sometimes needs exponential space. Fgrep patterns are fixed 
strings ; it is fast and compact. The following options are recognized: 

—v All lines but those matching are printed. 

—x (Exact) only lines matched in their entirety are printed {fgrep 
only). 

—c Only a count of matching lines is printed. 

—1 Only the names of files with matching lines are listed (once), 
separated by new-lines, 

—n Each line is preceded by its relative line number in the file. 

—b Each line is preceded by the block number on which it was found. 

This is sometimes useful in locating disk block numbers by context. 
—s The error messages produced for nonexistent or unreadable files 

are suppressed {grep only). 

—e expression 

Same as a simple expression argument, but useful when the expres¬ 
sion begins with a — (does not work with grep). 

-{file 

The regular expression {egrep) or strings list {fgrep ) is taken from 
the file. 

In all cases, the file name is output if there is more than one input file. 
Care should be taken when using the characters S, •, [, |, (, ), and \ in 

expression, because they are also meaningful to the shell. It is safest to 
enclose the entire expression argument in single.quotes 

Fgrep searches for lines that contain one of the strings separated by 
new-lines. 

Egrep accepts regular expressions as in ed{ l), except for \( and \), with 
the addition of: 

1. A regular expression followed by + matches one or more 
occurrences of the regular expression. 

2. A regular expression followed by ? matches 0 or 1 occurrences of 
the regular expression. 

3. Two regular expressions separated by | or by a new-line match 
strings that are matched by either. 

4. A regular expression may be enclosed in parentheses () for group¬ 
ing. 
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The order of precedence of operators is [], then •?+, then concatena¬ 
tion, then | and new-line. 

SEE ALSO 

ed(l), sed(l), sh(l). 

DIAGNOSTICS 

Exit status is 0 if any matches are found, 1 if none, 2 for syntax errors or 
inaccessible files (even if matches were found). 

BUGS 

Ideally there should be only one grep, but we don't know a single algo¬ 
rithm that spans a wide enough range of space-time tradeoffs. 

Lines are limited to 256 characters; longer lines are truncated. 

Egrep does not recognize ranges, such as [a—z], in character classes. 
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NAME 

head — give first few lines 
SYNOPSIS 

head [ —count ] [ file ... ] 

DESCRIPTION 

This filter gives the first count lines of each of the specified files, or of 
the standard input. If count is omitted it defaults to 10. 

SEE ALSO 

tail (1) 
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NAME 

help — ask for help 

SYNOPSIS 

help [args] 

DESCRIPTION 

Help finds information to explain a message from a command or explain 
the use of a command. Zero or more arguments may be supplied. If no 
arguments are given, help will prompt for one. 

The arguments may be either message numbers (which normally appear 
in parentheses following messages) or command names, of one of the fol¬ 
lowing types: 

type 1 Begins with non-numerics, ends in numerics. The 
non-numeric prefix is usually an abbreviation for the 
program or set of routines which produced the mes¬ 
sage (e.g., ge6, for message 6 from the get command). 

type 2 Does not contain numerics (as a command, such as 
get) 

type 3 Is all numeric (e.g., 212) 

The response of the program will be the explanatory information related 
to the argument, if there is any. 

When all else fails, try "help stuck’’. 

FILES 

/usr/lib/help directory containing files of message text. 

DIAGNOSTICS 

Use help(l) for explanations. 
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NAME 

hp - handle special functions of HP 2640 and 2621-series terminals 

SYNOPSIS 

hp [ —e ] [ —m ] 

DESCRIPTION 

Hp supports special functions of the Hewlett-Packard 2640 series of ter¬ 
minals, with the primary purpose of producing accurate representations 
of most nroff(l) output. Typical uses are: 

nrofT —h files ... | hp 
nrofi —h —s ... files | hp 

In the latter case, rvroff will stop at the beginning of each page (including 
the first) and wait for you to hit line-feed (control-j) before resuming 
output. 

Regardless of the hardware options on your terminal, hp tries to do sen¬ 
sible things with underlining and reverse line-feeds. If the terminal has 
the “display enhancements" feature, subscripts and superscripts can be 
indicated in distinct ways. If it has the “mathematical-symbol" feature, 
Greek and other special characters can be displayed. 

The flags are as follows: 

—e It is assumed that your terminal has the “display enhancements" 

feature, and so maximal use is made of the added display modes. 
Overstruck characters are presented in the Underline mode. 
Superscripts are shown in Half-bright mode, and subscripts in 
Half-bright, Underlined mode. If this flag is omitted, hp assumes 
that your terminal lacks the "display enhancements” feature. In 
this case, all overstruck characters, subscripts, and superscripts 
are displayed in Inverse Video mode, i.e., dark-on-light, rather 
than the usual light-on-dark. 

-m Requests minimization of output by removal of new-lines. Any 
contiguous sequence of 3 or more new-lines is converted into a 
sequence of only 2 new-lines; i.e., any number of successive blank 
lines produces only a single blank output line. This allows you to 
retain more actual text on the screen. 

With regard to Greek and other special characters, hp provides the same 
set as does 300(1), except that "not" is approximated by a right arrow, 
and only the top half of the integral sign is shown. The display is ade¬ 
quate for examining output from neqn(l). 

DIAGNOSTICS 

"line too long" if the representation of a line exceeds 1,024 characters. 
The exit codes are 0 for normal termination, 2 for all errors. 

SEE ALSO 

300(1), col(l), greek(l), neqn(l), tbl(l), troff(l). 

BUGS 

An "overstriking sequence" is defined as a printing character followed by 
a backspace followed by another printing character. In such sequences, 
if either printing character is an underscore, the other printing charac¬ 
ter is shown underlined or in Inverse Video; otherwise, only the first 
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printing character is shown (again, underlined or in Inverse Video). 
Nothing special is done if a backspace is adjacent to an ASCII control 
character. Sequences of control characters (e.g.. reverse line-feeds, 
backspaces) can make text "disappear"; in particular, tables generated 
by fbf(l) that contain vertical lines will often be missing the lines of text 
that contain the "foot” of a vertical line, unless the input to hp is piped 
through cof(l). 

Although some terminals do provide numerical superscript characters, 
no attempt is made to display them. 
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NAME 

hyphen - find hyphenated words 

SYNOPSIS 

hyphen files 

DESCRIPTION 

Hyphen finds all the hyphenated words in files and prints them on the 
standard output. If no arguments are given, the standard input is used. 
Thus hyphen may be used as a filter. 

BUGS 

Hyphen can't cope with hyphenated tfafic (i.e., underlined) words; it will 
often miss them completely, or mangle them. 

Hyphen occasionally gets confused, but with no ill effects other than 
spurious extra output. 


I 
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NAME 

id — print user and group IDs and names 

SYNOPSIS 

id 

DESCRIPTION 

Id writes a message on the standard output giving the user and group IDs 
and the corresponding names of the invoking process. If the effective 
and real IDs do not match, both are printed. 

SEE ALSO 

logname(l), getuid(2), getgid(2). 
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NAME 

ifprolog — The prolog interpreter system 
SYNOPSIS 

ifprolog [ —c file ] [ —Is Size ] [ —gs Size ] [ —ts Size ] [ —dbs Size ] [ 
—fs Size ] name ... 

DESCRIPTION 

ifprolog is a prolog interpreter written in C. 

The options are: 

—c File 

The file File will be consulted, after the initialization of the inter¬ 
preter. This option may occur several times. 

—Is Size 

A local stack area of Size bytes will be allocated. 

—gs Size 

A global stack area of Size bytes will be allocated. 

—ts Size 

A trail area of Size bytes will be allocated. 

—dbs Size 

A datebase area of Size bytes will be allocated. 

—fs Size 

A functor/atom area of Size bytes will be allocated. 

SEE ALSO 

Clocksin, W.F., Mellish, C.S.: Programming in Prolog; Springer Verlag Ber¬ 
lin Heidelberg 1981 

IF/Prolog User’s Manual, Interface Computer GmbH 
LIMITATIONS 

ifprolog needs at least 300 Kbyte memory 

FILES 

/usr/lib/ifprolog/pl/boot needed for initialisation 
/usr/lib/ifprolog/pl/init needed for initialisation 
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NAME 

indent — indent and format a C program source 
SYNOPSIS 

indent ifile [ ofile ] [ args ] 

DESCRIPTION 

The arguments that can be specified follows. They may appear before or 
after the file names. 


ifile 

ofile 

Input file specification. 

Output file specification. 

If omitted, then the indented formatted file will be written back 

into the input file, and there will be a "back-up" copy of ifile 
written in the current directory. For an ifile named 
’’/blah/blah/file", the backup file will be named ".Bfile”. (It will 
only be listed when the *-a' argument is specified in Is.) If ofile is 
specified, indent checks to make sure it is different from ifile. 

-lnnn 

Maximum length of an output line. The default is 75. 

-ennn 

-cdnnn 

The column in which comments will start. The default is 33. 

The column in which comments on declarations will start. The 
default is for these comments to start in the same column as 
other comments. 

-innn 

The number of spaces for one indentation level. The default is 
4. 


-dj.-ndj -dj will cause declarations to be left justified, -ndj will cause 
them to be indented the same as code. The default is -ndj. 

-v-nv -v turns on ’’verbose" mode, -nv turns it off. When in verbose 
mode, indent will report when it splits one line of input into two 
or more lines of output, and it will give some size statistics at 
completion. The default is -nv. 

-bc,-nbc If -be is specified, then a newline will be forced after each 
comma in a declaration, -nbc will turn off this option. The 


-dnnn 

default is -be. 

This option controls the placement of comments which are not 
to the right of code. Specifying -d2 means that such comments 
will be placed two indentation levels to the left of code. The 
default -dO lines up these comments with the code. See the sec¬ 
tion on comment indentation below. 

-br,-bl 

Specifying -bl will cause complex statements to be lined up like 
this: 

if (...) 

I 

code 

Specifying -br (the default) will make them look like this. 

if (•••) 1 

code 

1 


Page 1 


February 17, 1984 




INDENT(l) 


MUNIX 


INDENT (1) 


You may set up your own 'profile' of defaults to indent by creating the 
file '/usr/your-name/.indent.pro’ (where your-name is your login name) 
and including whatever switches you like. If indent is run and a profile 
file exists, then it is read to set up the program’s defaults. Switches on 
the command line, though, will always over-ride profile switches. The 
profile file must be a single line of not more than 127 characters. The 
switches should be seperated on the line by spaces or tabs. Indent is 
intended primarily as a C program indenter. Specifically, indent will: 

> indent code lines 

> align comments 

> insert spaces around operators where necessary 

> break up declaration lists as in "int a.b.c;". 

It will not break up long statements to make them fit within the max¬ 
imum line length, but it will flag lines that are too long. Lines will be bro¬ 
ken so that each statement starts a new line, and braces will appear 
alone on a line. (See the -br option to inhibit this.) Also, an attempt is 
made to line up identifiers in declarations. 

Multi-line expressions 

Indent will not break up complicated expressions that extend over multi 
pie lines, but it will usually correctly indent such expressions which have 
already been broken up. Such an expression might end up looking like 
this: 

x = 

(Arbitrary parenthesized expression) 

+ 

(Parenthesized expression) 

(Parenthesized expression) 

) 

): 


Indent recognizes four kinds of comments. They are straight text, box 
comments, UNIX-style comments, and comments that should be passed 
thru unchanged. The action taken with these various types is as follows: 

"Box'' comments: The DSG documentation standards specify that boxes 
will be placed around section headers. Indent assumes that any com¬ 
ment with a dash immediately after the start of comment (i.e. "/•-*') is 
such a box. Each line of such a comment will be left unchanged, except 
that the first non-blank character of each successive line will be lined up 
with the beginning slash of the first line. Box comments will be indented 
(see below). 

Unix-style comments: This is the type of section header which is used 
extensively in the UNIX system source. If the start of comment (*/•') 


February 17. 1984 


Page 2 



INDENT (1) 


MUNIX 


INDENT (1) 


appears on a line by itself, indent assumes that it is a UNIX-style com¬ 
ment. These will be treated similarly to box comments, except the first 
non-blank character on each line will be lined up with the of the 

Unchanged comments: Any comment which starts in column 1 will be 
left completely unchanged. This is intended primarily for documentation 
header pages. The check for unchanged comments is made before the 
check for UNIX-style comments. 

Straight text: All other comments are treated as straight text. Indent 
will fit as many words (separated by blanks, tabs, or newlines) on a line as 
possible. Straight text comments will be indented. 

Comment indentation Box, UNIX-style, and straight text comments may 
be indented. If a comment is on a line with code it will be started in the 
"comment column", which is set by the -cnnn command line parameter. 
Otherwise, the comment will be started at nnn indentation levels less 
than where code is currently being placed, where nnn is specified by the 
-dnnn command line parameter. (Indented comments will never be 
placed in column 1.) If the code on a line extends past the comment 
column, the comment will be moved to the next line. 

Diagnostic error messsages, mostly to tell that a text line has been bro¬ 
ken or is too long for the output line, will be printed on the controlling 

tty. 

FILES 

/usr/your-name/.indent.pro — profile file 

BUGS 

Doesn’t know how to format "long" declarations. 
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NAME 

inews — submit news articles 


SYNOPSIS . r 

inews [ -h ] -t title [ -n newsgroups ] [ 

inews —p [ filename ] 

inews —C newsgroup 


expiration date ] 


Inews submits news articles to the USENET news network. It is intended 
as a raw interface, not as a human user interface. Casual users should 
probably use postnews(l) instead. 

The first form is for submitting user articles. The body will be read from 
the standard input. A title must be specified as there is no default. Each 
article belongs to a list of newsgroups. If the —n flag is omitted, the list 
will default to something line general. (On ours, it is general .) If you wish 
to submit an article in multiple newsgroups, the newsgroups must be 
separated by commas and/or spaces. If not specified, the expiration 
date will be set to the local default. The -f flag specifies the article’s 
sender. Without this flag, the sender defaults to the user’s name. If -f is 
specified, the real sender’s name will be included as a Sender line. The 
—h flag specifies that headers are present at the beginning of the article, 
and these headers should be included with the article header instead of 
as text. (This mechanism can be used to edit headers and supply addi¬ 
tional nondefault headers, but not to specify certain information, such 
as the sender and article ID. that inews itself generates.) 

When posting an article, the environment is checked for information 
about the sender. If NAME is found, its value is used for the full name, 
rather than the system value (often in /etc/passwd). This is useful if the 
system value cannot be set, or when more than one person uses the same 
login. If ORGANIZATION is found, the value overrides the system default 
organization. This is useful when a person uses a guest login and is not 
primarily associated with the organization owning the machine. 

The second form is used for receiving articles from other machines. If 
filename is given, the article will be read from the specified file, otherwise 
the article will be read from the standard input. An expiration date need 
not be present and a receival date, if present, will be ignored. 

After local installation, inews will transmit the article to all systems that 
subscribe to the newsgroups that the article belongs to. 

The third form is for creating new newsgroups. On some systems, this 
may be limited to specific users such as the super-user or news adminis¬ 
trator. (This happens on ours.) 

If the file /usr /lib/news/recording is present, it is taken as a list of 
"recordings” to be shown to users posting news. (This is by analogy to 
the recording you hear when you dial information in some parts of the 
country, asking you if you really wanted to do this.) The file contains 

lines of the form: 

newsgroups <tab> filename 
for example: 

net.all net.recording fa.all fa.recording 
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Any user posting an article to a newsgroup matching the pattern on the 
left will be shown the contents of the file on the right. The file is found in 
the LIB directory (often /usr/lib/news). The user is then told to hit DEL 
to abort or RETURN to proceed. The intent of this feature is to help com¬ 
panies keep proprietary information from accidently leaking out. 

FILES 

/usr / spool / news / .sys.nnn 

temporary articles 
/usr /spool/news /newsgroups /article _no. 

Articles 

/usr/spool/oldnews/ Expired articles 

/usr/hb/news/active List of known newsgroups and highest local article 

numbers in each. 

/usr/lib/news/seq Sequence number of last article 
/usr/lib/news/history 

List of all articles ever seen 
/usr/lib/news/sys System subscription list 

SEE ALSO 

Mail(l). mail(l). getdate(3). msgs(l), news(5). newsrc(5), postnews(l), 
readnews(l). recnews(l). sendnews(8). uucp(lC), uurec(8), 

AUTHORS 

Matt Glickman 
Mark Horton 
Stephen Daniel 
Tom R. Truscott 
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NAME 

join — relational database operator 
SYNOPSIS 

join [ options ] filel file2 
DESCRIPTION 

Join forms, on the standard output, a join of the two relations specified 
by the lines of filel and file2. If filel is the standard input is used. 

Pilel and file2 must be sorted in increasing ASCII collating sequence on 
the fields on which they are to be joined, normally the first in each line 

is one line in the output for each pair of lines in filel and^filei? 
have identical join fields. The output line normally consists of the com¬ 
mon field, then the rest of the line from filel, then the rest of the line 
from file2. 

Fields are normally separated by blank, tab or newline. In this case, mul¬ 
tiple separators count as one, and leading separators are discarded. 

These options are recognized: 

-an In addition to the normal output, produce a line for each unpair- 
able line in file n, where n is 1 or 2. 

—e s Replace empty output fields by string s. 

—jn m Join on the mth field of file n. If n is missing, use the mth field in 
each file. 

—° , 

Each output line comprises the fields specifed in list, each ele¬ 
ment of which has the form n.m, where n is a file number and m is 
a field number. 

—tc Use character c as a separator (tab character). Every appearance 

of c in a line is significant. 

SEE ALSO 

sort(l), comm(l), awk(l) 

BUGS . 

With default field separation, the collating sequence is that of sort-6; 

with —t, the sequence is that of a plain sort. 

The conventions of join, sort, comm, uniq, look and auifc(l) are wildly 
incongruous. 
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NAME 

kill - terminate a process 


SYNOPSIS 

kill [ -signo ] processid ... 

DESCRIPTION 

Kill sends signal 15 (terminate) to the specified processes This will nor¬ 
mally kill processes that do not catch or ignore the signal. The process 
number of each asynchronous process started with Sc is reported by the 
Shell (unless more than one process is started in a pipeline in which 
case the number of the last process in the pipeline is reportec,. Process 
numbers can also be found by using ps(l). 

The details of the kill are described in kUl{Z). For example, if process 
number 0 is specified, all processes in the process group are signaled. 

The killed process must belong to the current user unless he is the 
super-user. 

If a signal number preceded by - is given as first argument, that signal is 
sent instead of terminate (see signal(2)). In particular kill 9 ••• is a 
sure kill. 


SEE ALSO 

ps(l), sh(l). kill(2), signal(2). 
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NAVE 

Id — loader 
SYNOPSIS 

Id [ option ] file ... 

DESCRIPTION 

‘ nto , on r- res ° ,v ' s ^ 

are given, and Id combines them, producer an obfe e c t S mod a i ° h ^ cl , files 
be either executed or become the inout Lr » f,K m °^ u,e whlch can 
latter case, the -r option mTst be2 to1 ^ W , run (In the 

The output of Id is left on out This fii ^ ser ^ e relocation bits ) 
errors occurred during the Toad ^ 15 CXeCUtable only if no 

argume^r^a Tibrary! ItV MaJih^elcMtl^''once' 

unresolved 6 external r^freTce'are^loaded 'l^a^routine? “ 

references another routine in the library «nH *k i l ne a library 

processed by ranlib(i) the referenced ? d the lbrar F has not been 
referencing "routine ^ the 

libraries may be important II the first member of J , P :°® rams withi " 

'-SYVDEF'. then it is understood tote.“”to„.rv for th.^h“ 

as produced by ranlib; the dictionary is searched Herati.Jl* U ?“ Ch 
many references as possible. ratively to satisfy as 

The symbols -_etext\ '_edata' and * end’ Cetexf -edat*’ »r,d • 

are reserved, and if referred to ar7 set L ihl « . , d end m C ) 

program, the first location above initialized data^ndTn a ^° Ve the 
above all data respectively It is errnneof,* ,^'^ d t he firsl ,oca tion 

Ld understands several options. ExceDt for —I u 

the file names They may be c.Unated m the usuaUo™ -° r ' 

—Start prog main.o . Note however that Dackinn of tK ^^ eso 

significant (see beiow, U without * 

°-m n p| C e h in n ft'eVd h 'o! ib ri, r tfrhhc m : '(he''ilb^y^i^^ V 

This option is used to link Unix or standalone programs wUm 
code is in segment 0 and data and bss in segment ^ m h * 

Force definition of common storage even if the -r flag is present 

The following argument is taken to be the name cf ik« 

of the loaded program Default is the label * entry If R ex"sU or 
otherwise location 0. * 11 exis ^ s °r 

This option is on abbreviation lor the library name Vlib/lihr «• 
where I ,s a string 11 that does not exist. Id tries ^usrri b/ hs a-' 

A library is searched when its name is encountered » iSe 


-b 


-lx 
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“P 
—r 


-t 


—u 


—x 


-J 


-K 


placement of a —1 is significant. 

The name argument after -o is used as the name of the Id output 
file, instead of a.out. F 1 

This argument produces a symbol listing on stdout. 

Cenerate relocation bits in the output file so that it can be the 
subject of another Id run. This flag also prevents final definitions 
from being given to common symbols, and suppresses the 
undefined symbol diagnostics. e 

•Strip’ the output, that is. remove the symbol table and relocation 
bits to save space (but impair the usefulness of the debugger) 

This information can also be removed by sfrip(i) 

’Trace’ library searches: Pont for every object module the reason 
why it is loaded. a5 ° n 

Take the following ar e ument as a symbol and entar it as undefined 
n the symbol table. This is useful for loading wholly from a 
library, since initially the symbol table is empty and an unresolved 
reference is needed to force the loading of the first routine. 

Do not preserve local (non-.globl) symbols in the output symbol 
table; on y enter external symbols. This option saves some space 
in the output file. K 

This argument links objects for an unmapped address range, such 
that code and data start from OxfTBOOO and bss starts from 
OxffaOOO. Useful for Macsbug etc. 


—TDB 


The following argument is a number in C notation, which deter- 
mines the stack size of the generated program (cf. sffcsiz(i)) 

This is an overlay file, only the text segment will be replaced bv 
exec (2) Shared data must have the same layout as in the pro¬ 
gram overlaid. y 

For each of these options, the following argument is a number in C 
notation, which determines the start address of the text, data or 
bss segment, respectively (i.e code, initialized data, and non- 
mitiahzed data, respectively). If two or three of these options are 
given together, the respective segments are linked consecutively 
from the given address. Overlapping address ranges are rejected 

-Y The following argument is a number in C notation, which deter- 
mines the size of the symbol table (default 1009 symbols) —Y 
should be the first Id option. ' 

The following table describes the options that specify start addresses of 

segments in terms of the options -T/D/B The options are listed with 

decreasing priority. 


-r -TDB 0 
—TDB self-describing 
—y -TD 0xfT8000 -B OxffaOOO 

-b -T 0-DB 0x100000 

none -T 0x600000 -DB 0x800000 (or 0x900000 or OxaOOOOO or if the 
text segment is larger than 2. 3. ... MBytes) 
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FILES 

/lib/lib*.a libraries 

/lib/libL*.a libraries with four-byte integers 

/usr/lib/lib*.a more libraries 
a out output file 

SEE ALSO 

as(l), ar(l), cc(l). dprom(l). ranlib(l) 

BUGS 

Only 4-byte addresses are relocated; that is, a68 'addr:W won’t work 
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NAME 

learn — computer aided instruction about UNIX 
SYNOPSIS 

learn [ —directory ] [ subject [ lesson [ speed ] ] ] 

DESCRIPTION 

Learn gives CAI courses and practice in the use of UNIX. To get started 
simply type 'learn'. The program will ask questions to find out what you 
want to do. The questions may be bypassed by naming a subject, and the 
last Lesson number that Learn told you in the previous session. You may 
also include a speed number that was given with the lesson number (but 
without the parentheses that learn places around the speed number). If 
Lesson is Learn prompts for each lesson; this is useful for debugging. 

The subjects presently handled are 

editor 

eqn 

files 

macros 

morefiles 

C 

The special command 'bye' terminates a learn session. 

The —directory option allows one to exercise a script in a nonstandard 
place. 

FILES 

/usr/lib/learn and all dependent directories and files 

BUGS 

The main strength of learn, that it asks the student to use the real UNIX, 
also makes possible baffling mistakes. It is helpful, especially for nonpro¬ 
grammers, to have a UNIX initiate near at hand during the first sessions. 

Occasionally lessons are incorrect, sometimes because the local version 
of a command operates in a non-standard way. Such lessons may be 
skipped, but it takes some sophistication to recognize the situation. 
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NAME 

leave - remind you when you have to leave 

SYNOPSIS 

leave [ hhmm ] 

DESCRIPTION 

Leave waits until the specified time, then reminds you that you have to 
leave. You are reminded 5 minutes and 1 minute before the actual time, 
at the time, and every minute thereafter. When you log off, leave exits 
just before it would have printed the next message. 

The time of day is in the form hhmm where hh is a time in hours (on a 12 
or 24 hour clock). All times are converted to a 12 hour clock, and 
assumed to be in the next 12 hours. 

If no argument is given, leave prompts with "When do you have to leave?”. 
A reply of newline causes leave to exit, otherwise the reply is assumed to 
be a time. This form is suitable for inclusion in a .login or .profile. 

Leave ignores interrupts, quits, and terminates. To get rid of it you 
should either log of! or use "kill -9” giving its process id. 

SEE ALSO 

calendar(l) 

AUTHOR 

Mark Horton 

BUGS 
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NAME 

lex — generator of lexical analysis programs 
SYNOPSIS 

lex [ —tvfn ] [ file ] ... 

DESCRIPTION 

Lex generates programs to be used in simple lexical analyis of text. The 
input files (standard input default) contain regular expressions to be 
searched for, and actions written in C to be executed when expressions 

are found. 

A C source program, 'lex.yy.c' is generated, to be compiled thus: 
cc lex.yy.c —11 

This program, when run, copies unrecognized portions of the input to the 
output, and executes the associated C action for each regular expression 
that is recognized. 

The following lex program converts upper case to lower, removes blanks 
at the end of lines, and replaces multiple blanks by single blanks. 

%% 

’A-Z] putchar(yytext[0]+'a'-'A'); 

; ]+S 

’ ]+ putchar(''): 

The options have the following meanings. 

—t Place the result on the standard output instead of in file Tex.yy.c’. 

—v Print a one-line summary of statistics of the generated analyzer. 

—n Opposite of —v; —n is default. 

—f ‘Faster’ compilation: don’t bother to pack the resulting tables; lim¬ 

ited to small programs. 

SEE ALSO 

yacc(l) 

M. E. Lesk and E. Schmidt, LEX— Lexical Analyzer Generator 
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NAME 

line — read one line 

SYNOPSIS 

line [lineno] 

DESCRIPTION 

Line copies one line (up to a new-line) from the standard input and 
writes it on the standard output. If no parameter is given, the first line is 
read. The command line 2 will read the second line etc. It returns an 
exit code of 1 on EOF and always prints at least a new-line. It is often 
used within shell files to read from the user's terminal. 

SEE ALSO 

sh(l), read(2). 
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NAME 

lint — a C program verifier 


SYNOPSIS 

lint [ —abchnpuvx ] file ... 

DESCRIPTION „ .. ... . . 

Lint attempts to detect features of the C programmes which are likely to 
be bugs, or non-portable, or wasteful. It also checks the type usage of 
the program more strictly than the compilers. Among the things which 
are currently found are unreachable statements, loops not entered at 
the top, automatic variables declared and not used, and logical expres¬ 
sions whose value is constant. Moreover, the usage of functions is 
checked to find functions which return values in some places and not in 
others, functions called with varying numbers of arguments, and func¬ 
tions whose values are not used. 


By default, it is assumed that all the files are to be loaded together; they 
are checked for mutual compatibility. Function definitions for certain 
libraries are available to lint-, thes* libraries are referred to by a conven¬ 
tional name, such as '-lm\ in the style of fd(l). 

Any number of the options in the following list may be used. The -D. -U. 
and -I options of cc(l) are also recognized as separate arguments. 

p Attempt to check portability to the IBM and GCOS dialects of C. 

h Apply a number of heuristic tests to attempt to intuit bugs, 

improve style, and reduce waste. 

b Report break statements that cannot be reached. (This is not the 
default because, unfortunately, most lex and many yocc outputs 
produce dozens of such comments.) 
v Suppress complaints about unused arguments in functions, 
x Report variables referred to by extern declarations, but never 
used. 


a Report assignments of long values to int variables, 
c Complain about casts which have questionable portability. 

u Do not complain about functions and variables used and not 
defined, or defined and not used (this is suitable for running lint 
on a subset of files out of a larger program), 
n Do not check compatibility against the standard library. 

Exit{2) and other functions which do not return are not understood; this 
causes various lies. 

Certain conventional comments in the C source will change the behavior 
of linf: 


/•NOTREACHED*/ 

at appropriate points stops comments about unreachable code 


/•VARARGSn*/ 

suppresses the usual checking for variable numbers of arguments 
in the following function declaration. The data types of the first n 
arguments are checked; a missing n is taken to be 0. 
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/•N0STR1CT*/ 

shuts off strict type checking in the next expression. 
/•ARGSUSED*/ 

turns on the —y option for the next function. 

/•LINTLIBRARYV 

at the beginning of a file shuts off complaints about unused func 
tions in this file. 

FILES 

/usr/lib/lint[l2] programs 

/usr/lib/llib-lc declarations for standard functions 
/usr/lib/llib-port declarations for portable functions 

SEE ALSO 

cc(l) 

S. C. Johnson, Lint, a CProgram Checker 

BUGS 

Lint has yet to be made compatible with the current definition of C. 
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NAME 

lock — reserve a terminal 

SYNOPSIS 

lock 

DESCRIPTION 

Lock requests a password from the user, then prints "LOCKED" on the ter¬ 
minal and refuses to relinquish the terminal until the password is 
repeated. If the user forgets the password, he has no other recourse but 
to login elsewhere and kill the lock process. 

AUTHOR 

Kurt Shoens 

BUGS 

Should timeout after 15 minutes. 
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NAME 

login - sign on 
SYNOPSIS 

login [ name [ env-var ... ]] 

DESCRIPTION 

The login command is used at the beginning of each terminal session and 
allows you to identify yourself to the system. It may be invoked as a 
command or by the system when a connection is first established. Also, 
it is invoked by the system when a previous user has terminated the ini¬ 
tial shell by typing a cntrl-z to indicate an "end-of-file.” 

The shell handles login specially, so that login used as a command super¬ 
sedes the shell, as if ' exec login” had been typed. 

Login asks for your user name (if not supplied as an argument), and, if 
appropriate, your password. Echoing is turned off (where possible) dur¬ 
ing the typing of your password, so it will not appear on the written 
record of the session. 

At some installations, an option may be invoked that will require you to 
enter a second "dialup” password. This will occur only for dial-up con¬ 
nections, and will be prompted by the message "dialup password:". Both 
passwords are required for a successful login. 

If you do not complete the login successfully within a certain period of 
time (e.g., one minute), you are likely to be silently disconnected. 

After a successful login, accounting files are updated, the procedure 
/etc/profile is performed, the message-of-the-day, if any, is printed, the 
user-ID, the group-lD, the working directory, and the cpmmand inter¬ 
preter (usually s/i(D) is initialized, and the file .profile in the working 
directory is executed, if it exists. These specifications are found in the 
/etc/passwd file entry for the user. The name of the command inter¬ 
preter is — followed by the last component of the interpreter’s pathname 
(i.e., —sh). If this field in the password file is empty, then the default 
command interpreter, /bin/sh is used. 

The basic environment (see «nvtron(7)) is initialized to: 

HOUE=your-login-directory 
PATH=:/bin:/usr/bin 
SHElL=last-field-of-passwd-entry 
MAIL= /usr/mail /your-login-name 
TZ=timezone-specification 

The environment may be expanded or modified by supplying additional 
arguments to login, either at execution time or when login requests your 
login name. The arguments may take either the form xxx or xxx=yyy. 
Arguments without an equal sign are placed in the environment as 
Ln=xxx 

where n is a number starting at 0 and is incremented each time a new 
variable name is required. Variables containing an = are placed into the 
environment without modification. If they already appear in the environ¬ 
ment, then they replace the older value. There are two exceptions. The 
variables PATH and SHELL cannot be changed. This prevents people, 
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logging into restricted shell environments, from spawning secondary 
shells which aren't restricted. Both login and getty understand simple 
single character quoting conventions. Typing a backslash in front of a 
character quotes it and allows the inclusion of such things as spaces and 

tabs. 

FILES 

/etc/utmp accounting 

/etc/wtmp accounting 

/usr /mail /your-name mailbox for user your-name 

/etc/motd message-of-the-day 

/etc/passwd password file 

/etc/profile system profile 

profit user’s login profile 

SEE AL mail(l). newgrp(l), sh(l), su(l). passwd(5), profile(5). environ(7). 

D1AGN °f 0 T gin incorrect if the user name or the password cannot be matched. 

No shell, cannot open password fiU. or no directory: consult a UNIX Sys 

rJ^“rou-^ 0 « r x,c "login" from *. lon,'s, l.v'1 ", if you 

attempted to execute login as a command from other than the mu-1 
shell. 
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NAME 

logname — get login name 

SYNOPSIS 

logname 

DESCRIPTION 

Logname returns the contents of the environment variable SLOGNAHE. 
which is set when a user logs into the system. 

FILES 

/etc/profile 
SEE ALSO 

env(l), login(l), logname(3X), environ(7). 
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NAME 

look — find lines in a sorted list 
SYNOPSIS 

look [ -df ] string [ file ] 

DESCRIPTION 

Look consults a sorted file and prints all lines that begin with string. It 
uses binary search. 

The options d and f affect comparisons as in sorf(l): 

d 'Dictionary' order: only letters, digits, tabs and blanks participate in 
comparisons. 

f Fold. Upper case letters compare equal to lower case. 

If no file is specified, /usr/diet/words is assumed with collating sequence 
-df. 

FILES 

/usr/dict/words 

SEE ALSO 

sort(l), grep(l) 


\ 
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NAME 

lorder - find ordering relation for an object library 

SYNOPSIS 

lorder file ... 

DESCRIPTION , 

The input is one or more object or library archive (see or(l)) files. The 
standard output is a list of pairs of object file names, meaning that the 
first file of the pair refers to external identifiers defined in the second. 
The output may be processed by fsorf(l) to find an ordering of a library 
suitable for one-pass access by ld{ l). 

This brash one-liner intends to build a new library from existing ‘.o' files, 
ar cr library 'lorder *.o | tsort' 

FILES 

*symref, *symdef 

nm(l), sed(l), sort(l), join(l) 

SEE ALSO 

tsort(l), ld(l). ar(l) 

BUGS 

The names of object files, in and out of libraries, must end with ‘.o'; non¬ 
sense results otherwise. 
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NAME 

lpctrl - set options on the parallel line printer 
SYNOPSIS 

lpctrl [ option ... ] 

DESCRIPTION 

Lpctrl sets certain I/O options on the parallel line printer. With no argu¬ 
ment. it reports the current settings of the options. The option strings 
are selected from the following set: 

trans switch to transparent mode 
—trans switch ofT transparent mode 

cap map lower case letters to upper case (capital mode) 

—cap do not map letters 
line n set page length to n (n>0). 
col n set line length to n (n>0). 
indent n 

set indent to n (n>=0). 

FILES 

/dev/lp 
SEE ALSO 

lpr(l), ioctl(2), lp(4) 
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NAME 

lpr — line printer spooler 
SYNOPSIS 

lpr [ option ... ] [ name ... ] 

DESCRIPTION 

Lpr causes the jiamed files to be queued for printing on a line printer. If 
no names appear, the standard input is assumed; thus lpr may be used 
as a filter. 

The following options may be given (each as a separate argument and in 
any order) before any file name arguments: 

—c Makes a copy of the file to be sent before returning to the user. 

—r Removes the file after sending it. 

-m When printing is complete, reports that fact by mail(l). 

—n Does not report the completion of printing by matZ(l). This is the 

default option. 

FILES 

/etc/passwd user’s identification and accounting data. 

/usr/lib/lpd line printer daemon. 

/usr/spool/lpd/* spool area. 

SEE ALSO 

lpd(8). 
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NAME 

Is. 11. 1, lr. If, lx — list contents of directory 
SYNOPSIS 

Is [ —ltasdrucifg ] name ... 

DESCRIPTION 

For each directory argument, Is lists the contents of the directory; for 
each file argument, Is repeats its name and any other information 
requested. The output is sorted alphabetically by default. When no argu¬ 
ment is given, the current directory is listed. When several arguments 
are given, the arguments are first sorted appropriately, but file argu¬ 
ments appear before directories and their contents. There are several 
options: 

—1 List in long format, giving mode, number of links, owner, size in 
bytes, and time of last modification for each file. (See below.) If 
the file is a special file the size field will instead contain the major 
and minor device numbers. 

—t Sort by time modified (latest first) instead of by name, as is nor¬ 

mal. 

—a List all entries; usually filenames starting with a are suppressed. 

—s Give size in blocks, including indirect blocks, for each entry. 

—d If argument is a directory, list only its name, not its contents 

(mostly used with —1 to get status on directory). 

—r Reverse the order of sort to get reverse alphabetic or oldest first 

as appropriate. 

—u Use time of last access instead of last modification for sorting (—t) 

or printing (—1). 

—c Use time of last modification to inode (mode, etc.) instead of last 

modification to file for sorting (—t) or printing (—1). 

—i Print i-number in first column of the report for each file listed. 

—f Force each argument to be interpreted as a directory and list the 

name found in each slot. This option turns off —1. —t, —s, and —r, 
and turns on —a; the order is the order in which entries appear in 
the directory. 

—g Give group ID instead of owner ID in long listing. 

The mode printed under the —1 option contains 11 characters which are 
interpreted as follows: the first character is 

d if the entry is a directory; 
b if the entry is a block-type special file; 
c if the entry is a character-type special file; 

— if the entry is a plain file. 

The next 9 characters are interpreted as three sets of three bits each. 
The first set refers to owner permissions; the next to permissions to oth¬ 
ers in the same user-group; and the last to all others. Within each set 
the three characters indicate permission respectively to read, to write, 
or to execute the file as a program. For a directory, ‘execute’ permission 
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is interpreted to mean permission to search the directory for a specified 
file. The permissions are indicated as follows: 

r if the file is readable; 
w if the file is writable; 
x if the file is executable; 

- if the indicated permission is not granted. 

The group-execute permission character is given as s if the file has set- 
group-ID mode; likewise the user-execute permission character is given 
as s if the file has set-user-ID mode. 

The last character of the mode (normally 'x' or is t if the 100C bit of 
the mode is on. See chmod(l) for the meaning of this mode. 

When the sizes of the files in a directory are listed, a total count of 

blocks, including indirect blocks is printed. 


TO SH 

The names 11, 1, lr, If, lx should be linked to Is. LI is the same as Is -1; 1 
gives a compact listing of the names; lr goes recursively through the 
directories; If puts a *•’ after the names of executable files and a / after 
the names of directories; lx sorts names rowwise instead of columnwise. 


/etc/passwd to get user ID’s for ‘Is -1\ 

/etc/group to get group ID’S for‘Is-g’. 

/bin/ls, /bin/11, /bin/1, /bin/lr. /bin/lf. /bm/lx 
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NAME 

Itroff. vtroff - troff to the CANON LBP or the Versatec V80 
SYNOPSIS 

ltroff/vtroff [ —F majorfont ] [ —123 minorfont 1 [ —Uenqth. 1 T —x 1 
troff arguments J 1 J 

DESCRIPTION 

Ltroff/vtroff runs troff (1) sending its output through various programs to 
produce typeset output on the V80 for vtroff or the CANON LBP 10 for 
Itroff. The -1 (lower case 1) option causes the output to be split onto suc¬ 
cessive pages every length inches rather than the default 11". 

The default font is a Hershey font. If some other font is desired you can 
gi\e a F argument and then the font name. This will place normal, italic 
and bold versions of the font on positions 1. 2. and 3. To place a font 
only on a single position, you can give an argument of the form —n and 
the minor font name. A ,v will be added to the minor font name if 
needed. Thus "vtroff -ms paper” will set a paper in the Hershey font, 
while "vtroff -F nonie -ms paper" will set the paper in the (sans serif) 
nonie font. The —x option asks for exact simulation of photo-typesetter 
output. (I.e. using the width tables for the C.A.T. photo-typesetter) 

FILES 

/usr/lib/tmac/tmac.vcatdefault font mounts and bug fixes 
/usr/lib/fontinfo/* fixes for other fonts 
/usr/lib/vfont directory containing fonts 

SEE ALSO 

troff(l), vfont(5) 

BUGS 

The Versatec fonts with a resolution of 240 dots per inch are also used 
for the LBP 10 with a resolution of 300 dots per inch. Accordingly, the 
fonts are smaller than they should be on the LBP. There exist modified 
macro packages -manl, -msl, -mel for the LBP, that set the default point 
size to 12 rather than 10. The resulting output is normally satisfactory, 
but complicated papers produced e.g. with eqn may exhibit errors. 


Page 1 


February 17,1984 












H4(l) 


MUNIX 


M4(l) 


NAME 

m4 — macro processor 
SYNOPSIS 

m4 [ options ] [ files ] 

DESCRIPTION 

M4 is a macro processor intended as a front end for Ratfor, C, and other 
languages. Each of the argument files is processed in order; if there are 
no files, or if a file name is —, the standard input is read. The processed 

text is written on the standard output. 

The options and their effects are as follows: 

—e Operate interactively. Interrupts are ignored and the output is 

unbuffered. Using this mode requires a special state of mind. 

—s Enable line sync output for the C preprocessor (#line ...) 

—Binf Change the size of the push-back and argument collection buffers 
from the default of 4,096. 

—Hinf Change the size of the symbol table hash array from the default of 
199. The size should be prime. 

—Sinf Change the size of the call stack from the default of 100 slots. 
Macros take three slots, and non-macro arguments take one. 

—Tinf Change the size of the token buffer from the default of 512 bytes. 

To be effective, these flags must appear before any file names and before 
any —D or —U flags: 

—Dname[=val] 

Defines name to val or to null in val's absence. 

—Uname 

undefines name. 

Macro calls have the form: 

name(argl,arg2.argn) 

The ( must immediately follow the name of the macro. If a defined macro 
name is not followed by a (, it is deemed to have no arguments. Leading 
unquoted blanks, tabs, and new-lines are ignored while collecting argu¬ 
ments. Potential macro names consist of alphabetic letters, digits, and 
underscore where the first character is not a digit. 

Left and right single quotes are used to quote strings. The value of a 
quoted string is the string stripped of the quotes. 

When a macro name is recognized, its arguments are collected by search¬ 
ing for a matching right parenthesis. Macro evaluation proceeds nor¬ 
mally during the collection of the arguments, and any commas or right 
parentheses which happen to turn up within the value of a nested call 
are as effective as those in the original input text. After argument col¬ 
lection, the value of the macro is pushed back onto the input stream and 
rescanned. 

M4 makes available the following built-in macros. They may be redefined, 
but once this is done the original meaning is lost. Their values are null 
unless otherwise stated. 
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define 


undefine 

defn 

pushdef 

popdef 

ifdef 


the second argument is installed as the value of the macro 
■whose name is the first argument. Each occurrence of Sn in 
the replacement text, where n is a digit, is replaced by the n- 
th argument. Argument 0 is the name of the macro; missing 
arguments are replaced by the null string; S# is replaced by 
the number of arguments; S* is replaced by a list of all the 
arguments separated by commas; is like S*. but each argu¬ 
ment is quoted (with the current quotes). 

removes the definition of the macro named in its argument. 

returns the quoted definition of its argument(s). It is useful 
for renaming macros, especially built-ins. 

like define , but saves any previous definition. 

removes current definition of its argument(s), exposing the 
previous one if any. 

if the first argument is defined, the value is the second argu¬ 
ment, otherwise the third. If there is no third argument, the 
value is null. The word unix is predefined on UNIX versions of 
m.4. 


shift returns all but its first argument. The other arguments are 

quoted and pushed back with commas in between. The quot¬ 
ing nullifies the effect of the extra scan that will subsequently 
be performed. 


changequote 

change quote symbols to the first and second arguments. The 
symbols may be up to five characters long. Changequote 
without arguments restores the original values (i.e., ' '). 


changecom 

change left and right comment markers from the default # 
and new-line. With no arguments, the comment mechanism is 
effectively disabled. With one argument, the left marker 
becomes the argument and the right marker becomes new- 
line. With two arguments, both markers are affected. Com¬ 
ment markers may be up to five characters long. 

divert m4 maintains 10 output streams, numbered 0-9. The final 
output is the concatenation of the streams in numerical 
order; initially stream 0 is the current stream. The divert 
macro changes the current output stream to its (digit-string) 
argument. Output diverted to a stream other than 0 through 
9 is discarded. 

undivert causes immediate output of text from diversions named as 
arguments, or all diversions if no argument. Text may be 
undiverted into another diversion. Undiverting discards the 
diverted text. 

divnum returns the value of the current output stream. 

dnl reads and discards characters up to and including the next 

new-line. 
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ifelse 

has three or more arguments. If the first argument is the 
same string as the second, then the value is the third argu¬ 
ment. If not, and if there are more than four arguments, the 
process is repeated with arguments 4, 5. 6 and 7. Otherwise, 
the value is either the fourth string, or, if it is not present, 
null. 

incr 

returns the value of its argument incremented by 1. The 

value of the argument is calculated by interpreting an initial 
digit-string as a decimal number. 

deer 

returns the value of its argument decremented by 1. 

eval 

evaluates its argument as an arithmetic expression, using 32- 
bit arithmetic. Operators include +, —, *, /, %, ~ (exponentia¬ 
tion), bitwise |, and relational; parentheses. Octal and 
hex numbers may be specified as in C. The second argument 
specifies the radix for the result; the default is 10. The third 
argument may be used to specify the minimum number of 
digits in the result. 

len 

index 

returns the number of characters in its argument. 

returns the position in its first argument where the second 
argument begins (zero origin), or -1 if the second argument 
does not occur. 

substr 

returns a substring of its first argument. The second argu¬ 
ment is a zero origin number selecting the first character; the 
third argument indicates the length of the substring. A miss¬ 
ing third argument is taken to be large enough to extend to 
the end of the first string. 

translit 

transliterates the characters in its first argument from the 
set given by the second argument to the set given by the 
third. No abbreviations are permitted. 

include 

sinclude 

returns the contents of the file named in the argument. 

is identical to include, except that it says nothing if the file is 
inaccessible. 

syscmd 

executes the UNIX command given in the first argument. No 
value is returned. 


sysval is the return code from the last call to syscmd. 
maketemp fills in a string of XXXXX in its argument with the current pro 


m4exit 

cess ID. 

causes immediate exit from m4. Argument 1. if given, is the 
exit code; the default is 0. 

m4wrap 

argument 1 will be pushed back at final EOF: example: 
m4wrap('cleanup()') 

errprint 

dumpdef 

prints its argument on the diagnostic output file. 

prints current names and definitions, for the named items, or 
for all if no arguments are given. 
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traceon with no arguments, turns on tracing for all macros (including 
built-ins). Otherwise, turns on tracing for named macros. 

traceoff turns off trace globally and for any macros specified. Macros 
specifically traced by traceon can be untraced only by 
specific calls to traceoff. 

SEE ALSO 

The M4 Macro Processor by B. W. Kemighan and D. M. Ritchie. 
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NAME 

mail, rmail — send mail to users or read mail 
SYNOPSIS 

mail [ —epqr ] [ -f file ] 
mail [ —t ] persons 
rmail [ —t ] persons 


DESCRIPTION 

Mail without arguments prints a user's mail, message-by-message in 
Jast-m, first-out order. For each message, the user is prompted with a ?. 
ar.c a line is read from the standard input to determine the disposition of 
the message: 


<new-line> 

+ 

d 

P 

s [ files .] 
w [ files ] 

m [ persons ] 

q 

EOT (control-d) 

X 

Jcommand 


Go on to next message. 

Same as <new-line>. 

Delete message and go on to next message. 

Print message again. 

Go back to previous message. 

Save message in the named files (mbox is default). 
Save message, without its header, in the named 
files (mbox is default). 

Mail the message to the named persons (yourself is 
default). 

Put undeleted mail back in the mailfile and stop. 
Same as q. 

Put all mail back in the mailfile unchanged and 
stop. 

Escape to the shell to do command. 

Print a command summary. 


The optional arguments alter the printing of the mail: 


-e causes mail not to be printed. An exit value of 0 is returned if the 
user has mail; otherwise, an exit value of 1 is returned. 

-p causes all mail to be printed without prompting for disposition, 
q causes mail to terminate after interrupts. Normally an interrupt 
only causes the termination of the message being printed. 

— r causes messages to be printed in first-in, first-out order. 

-tfile causes mail to us e file (e.g., mbox) instead of the default mailfile. 

When persons are named, mail takes the standard input up to an end- 
of-file (or up to a line consisting of just a .) and adds it to each person’s 
mailfile. The message is preceded by the sender’s name and a postmark. 
Lines that look like postmarks in the message, (i.e., "From...”) are pre¬ 
ceded with a >. The -t option causes the message to be preceded by all 
persons the mail is sent to. A person is usually a user name recognized 
by login(l). If a person being sent mail is not recognized, or if mail is 
interrupted during input, the file dead.letter will be saved to allow editing 
and resending. 


To denote a recipient on a remote system, prefix person by the system 
name and exclamation mark (see uucp(lC)). Everything after the first 
exclamation mark in persons is interpreted by the remote system. In 
particular, if persons contains additional exclamation marks, it can 
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denote a sequence of machines through which the message is to be sent 
on the way to its ultimate destination. For example, specifying a!b!cde as 
a recipient's name causes the message to be sent to user bicde on system 
a. System a will interpret that destination as a request to send the mes¬ 
sage to user cde on system b. This might be useful, for instance, if the 
sending system can access system a but not system b. and system a has 
access to system b. 

The mailfile may be manipulated in two ways to alter the function of 
mail. The other permissions of the file may be read-write, read-only, or 
neither read nor write to allow different levels of privacy. If changed to 
other than the default, the file will be preserved even when empty to per¬ 
petuate the desired permissions. The file may also contain the first line: 

Forward to person 

which will cause all mail sent to the owner of the mailfile to be forwarded 
to person. This is especially useful to forward all of a person’s mail to 
one machine in a multiple machine environment. 

Rmail only permits the sending of mail; uucp(lC) uses rmail as a secu¬ 
rity precaution. Rmail is a link to mail. 

When a user logs in, the presence of mail, if any. is indicated. Also, 
notification is made if new mail arrives while using mail. 

FILES 

/etc/passwd to identify sender and locate persons 
/usr/mail/ttser incoming mail for user, i.e., the mailfile 
JHOME/mbox saved mail 

SMAIL variable containing path name of mailfile 

/tmp/ma* temporary file 

/usr/mail/*.lock 

lock for mail directory 
dead.letter unmailable text 

SEE ALSO 

login(l), uucp(lC), write(l). 

BUGS 

Race conditions sometimes result in a failure to remove a lock file. 

After an interrupt, the next message may not be printed; printing may be 
forced by typing a p. 
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NAME 

mail.nc - mail(l) using the Newcastle Connection instead of uucp 
DESCRIPTION 

t C h e an r 8 on S t : 5 " s y ste t m! P ers ° n '’- "system" is now recognised as the name of 
\rL «t f S n S r^ m m the New , castle Connection distributed naming 
t T^' ° a uucp(lC) system name (especially, there are no embedded "Vs 

S > SlclTl J . 

Mail.nc spawns a single mail process on each remote system to distribute 
Th e .<T ai l ° 3 recipients on that system (local mail behaves as usual) 

mail.nc /../unixlldave /../unix2!dave /../unixllfred” calls 
"mail dave fred" on /../unixl and 
"mail dave" on /../unix2. 

SEE ALSO 

mail(l) for a full description of this command. 


BUGS 


Cannot forward messages to remote systems from within mail, 
if execution of mail on a remote system does not succeed, it is difficult to 
know what messages have been sent. 

Mail expects all "real" mail commands to live in files of the same path¬ 
name on all systems. r 
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* ♦ 

NAME 

make — maintain, update, and regenerate groupe of programs 
SYNOPSIS 

[-P) [-*] t-kj [-•] [-rj £-n] I-b] [-«] [-m] [-ij 

l-qj l“«J l names J 

DESCRIPTION 

The following is a brief description of all options and some special names: 

-f makefile Description file name. Makefile is assumed to be the name of 


-p 

a description file. A hie name of — denotes the standard 
input The contents of makefile override the built-in ruler if 
they are present. 

Print out the complete set of macro definitions and target 
descriptions. 

-1 

Ignore error codes returned by invoked commands. This 
mode is entered If the fake target name .IGNORE appears in 
the description file. 

-k 

—s 

Abandon work on the current entry, but continue on other 
branches that do not depend on that entry. 

Silent mode. Do not print command lines before executing. 

This mode is also entered if the fake target name .SILENT 
appears in the description file. 

—r 

Do not use the bullt*ln rules. 

—n 

No execute mode. Print commands, but do not execute 
them. Even lines beginning with an 0 are printed. 

-b 

Compatibility mode for old makefiles. 

Environment variables override assignments within 
makefiles. 

-t 

Touch the target files (causing them to be up-to-date) 
rather than issue the usual commands. 

-d 

Debug mode. Print out detailed information on files and 
times examined. 


Question. The maJet command returns a zero or non-zero 
status code depending on whether the target file is or is not 
up-to-date. 

.DEFAULT 

If a file must be made but there are no explicit commands or 
relevant built-in rules, the commands associated with the 
name .DEFAULT are used if it exists. 

•PRECIOUS 

Dependents of this target will not be removed when quit or 
interrupt are hit. 

•SILENT 

•IGNORE 

Same effect as the —s option. 

Same effect as the —i option. 


Make executes commands in makefile to update one or more target 
names. Name is typically a program. If no -f option is present, makefile, 
Makefile, s.makefile, and s.Makefile are tried in order. If makefile is —, 
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the standard input is taken. More than one —f makefile argument pair 
may appear. 

Make updates a target only if it depends on files that are newer than the 
target. All prerequisite files of a target are added recursively to the list 
of targets. Missing files are deemed to be out of date. 

Makefile contains a sequence of entries that specify dependencies. The 
first line of an entry is a blank-separated, non-null list of targets, then a 
:, then a (possibly null) list of prerequisite files or dependencies. Text 

following a ; and all following lines that begin with a tab are shell com¬ 
mands to be executed to update the target. The first line that does not 
begin with a tab or § begins a new dependency or macro definition. Shell 
commands may be continued across lines with the CbackslashXnew- 

line> sequence. Sharp (#) and new-line surround comments. 

The following makefile says that pgm depends on two files a.o and b.o, 
and that they in turn depend on their corresponding source files (a.c and 
b.c) and a common file incLh: 

pgm: a.o b.o 

cc a.o b.o —o pgm 

a. o: incl.h a.c 

cc —c a.c 

b. o: incl.h b.c 

cc —c b.c 

Command lines are executed one at a time, each by its own shell. A line 
is printed when it is executed unless the —s option is present, or the 
entry .SILENT: is in makefile, or unless the first character of the com¬ 
mand is @. The —n option specifies printing without execution; however, 
if the command line has the string S(UAKE) in it, the line is always exe¬ 
cuted (see discussion of the HAKEFLAGS macro under Environment). The 
—t (touch) option updates the modified date of a file without executing 
any commands. 

Commands returning non-zero status normally terminate make. If the —i 
option is present, or the entry .IGNORE: appears in makefile, or if the line 
specifying the command begins with <tab><hyphen>, the error is 
ignored. If the —k option is present, work is abandoned on the current 
entry, but continues on other branches that do not depend on that 
entry. 

The —b option allows old makefiles (those written for the old version of 
make) to run without errors. The difference between the old version of 
make and this version is that this version requires all dependency lines 
to have a (possibly null) command associated with them. The previous 
version of make assumed if no command was specified explicitly that the 
command was null. 

Interrupt and quit cause the target to be deleted unless the target 
depends on the special name .PRECIOUS. 

Environment 

The environment is read by make. All variables are assumed to be macro 
definitions, and processed as such. - The environment variables are pro¬ 
cessed before any makefile and after the internal rules; thus, macro 
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assignments in a makefile override environment variables. The —e option 
causes the environment to override the macro assignments in a makefile. 

The MAKEFLAGS environment variable is processed by make as containing 
any legal input option (except -f, -p, and -d) defined for the command 
line. Further, upon invocation, make "invents” the variable if it is not in 
the environment, puts the current options into it, and passes it on to 
invocations of commands. Thus, MAKEFLAGS always contains the current 
input options. This proves very useful for "super-makes". In fact, as 
noted above, when the — n option is used, the command $(MAKE) is exe¬ 
cuted anyway; hence, one can perform a make —n recursively on a whole 
software system to see what would have been executed. This is because 
the —n is put in MAKEFLAGS and passed to further invocations of J(MAKE). 
This is one way of debugging all of the makefiles for a software project 
without actually doing anything. 

Macros 

Entries of the form string 1 = string2 are macro definitions. Subsequent 
appearances of $(stringl[:subst J=[subsf2]]) are replaced by strings. 
The parentheses are optional if a single character macro name is used 
and there is no substitute sequence. The optional isubst l=subst2 is a 
substitute sequence. If it is specified, all non-overlapping occurrences of 
substl in the named macro are replaced by subst2. Strings (for the pur¬ 
poses of this type of substitution) are delimited by blanks, tabs, new-line 
characters, and beginnings of lines. An example of the use of the substi¬ 
tute sequence is shown under Libraries. 

Internal Macros 

There are five internally maintained macros which are useful for writing 
rules for building targets. 

S* The macro t* stands for the file name part of the current dependent 
with the suffix deleted. It is evaluated only for inference rules. 

S@ The %@ macro stands for the full target name of the current target. 
It is evaluated only for explicitly named dependencies. 

S< The S< macro is only evaluated for inference rules or the .DEFAULT 
rule. It is the module which is out of date with respect to the target 
(i.e., the "manufactured" dependent file name). Thus, in the .c.o 
rule, the S< macro would evaluate to the .c file. An example for 
making optimized .o files from .c files is: 

.c.o: 

cc —c —0 S*.c 
or: 

.c.o: 

cc —c —0 S< 

S? The S? macro, is evaluated when explicit rules from the makefile are 
evaluated. It is the list of prerequisites that are out of date with 
respect to the target; essentially, those modules which must be 
rebuilt. 

S% The S% macro is only evaluated when the target is an archive library 
member of the form lib(file.o). In this case, S@ evaluates to lib and 
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S% evaluates to the library member, file.o. 

Four of the five macros can have alternative forms. When an upper case 
D or F is appended to any of the four macros the meaning is changed to 
"directory part" for D and "file part” for F. Thus, S(®D) refers to the 
directory part of the string S®. If there is no directory part, The only 
macro excluded from this alternative form is S?. The reasons for this are 
debatable. 

Suffixes 

Certain names (for instance, those ending with .o) have inferable prere¬ 
quisites such as .c, .s. etc. If no update commands for such a file appear 
in makefile, and if an inferable prerequisite exists, that prerequisite is 
compiled to make the target. In this case, make has inference rules 

which allow building files from other files by examining the suffixes and 
determining an appropriate inference rule to use. The current default 
inference rules are: 

.c .c~ .sh .sh~ .c.o .c~.o .c~.c .s.o .s~.o .y.o .y~.o .l.o .l~.o 
.y.c .y'-.c .l.c .c.a .c~.a .s~.a .h^.h 

The internal rules for make are contained in the source file rules.c for 
the make program. These rules can be locally modified. To print out the 
rules compiled into the make on any machine in a form suitable for 
recompilation, the following command is used: 

make —fp — 2>/dev/null </dev/null 

The only peculiarity in this output is the (null) string which printf{ 3S) 
prints when handed a null string. 

A tilde in the above rules refers to an SCCS file (see sccsfile( 5)). Thus, the 
rule .c~.o would transform an SCCS C source file into an object file (.o). 
Because the s. of the SCCS files is a prefix it is incompatible with male's 
suffix point-of-view. Hence, the tilde is a way of changing any file refer¬ 
ence into an SCCS file reference. 

A rule with only one suffix (i.e. .c:) is the definition of how to build x from 
x.c. In effect, the other suffix is null. This is useful for building targets 
from only one source file (e.g., shell procedures, simple C programs). 

Additional suffixes are given as the dependency list for .SUFFIXES. Order 
is significant; the first possible name for which both a file and a rule exist 
is inferred as a prerequisite. 

The default list is: * 

.SUFFIXES: .o .c .y .1 .s 

Here again, the above command for printing the internal rules will 
display the list of suffixes implemented on the current machine. Multiple 
suffix lists accumulate; .SUFFIXES: with no dependencies clears the list of 
suffixes. 

Inference Rules 

The first example can be done more briefly: 

pgm: a.o b.o 

cc a.o b.o —o pgm 
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a.o b.o: incl.h 


This is because make has a set of internal rules for building files The 
user may add rules to this list by simply putting them in the makefile. 

Certain macros are used by the default inference rules to permit the 
inclusion of optional matter in any resulting commands. For examole 
C FLAGS. LFLAGS, and YFLAGS are used for compiler options to cc(n ?«(!)* 

and yacc(l) respectively. Again, the previous method for examining the 
current rules is recommended. 


The inference of prerequisites can be controlled. The rule to create a file 
with suffix .o from a file with suffix .c is specified as an entry with .c.o: as 
the target and no dependents Shell commands associated with the tar¬ 
get define the rule for making a .o file from a .c file. Any target that has 
no slashes in it and starts with a dot is identified as a rule and not a true 
target. 


Libraries 

If a target or dependency name contains parenthesis, it is assumed to be 
an archive library, the string within parenthesis referring to a member 
within the library. Thus lib(file.o) and S(LIB)(file.o) both refer to an 
archive library which contains file.o. (This assumes the LEB macro has 
been previously defined.) The expression S(LIB)(filel.o file2.o) is not 
legal. Rules pertaining to archive libraries have the form JOf.a where the 
XX is the suffix from which the archive member is to be made. An unfor¬ 
tunate byproduct of the current implementation requires the XX to be 
different from the suffix of the archive member. Thus, one cannot have 
lib(file.o) depend upon file.o explicitly. The most common use of the 
archive interface follows. Here, we assume the source files are all C type 
source: 


lib: lib(filel.o) lib(file2.o) lib(file3.o) 

©echo lib is now up to date 

.c.a: 

S(CC) -c $(CFLAGS) S< 
ar rv 8© S*.o 
rm -f S*.o 

In fact, the .c.a rule listed above is built into make and is unnecessary in 
this example. A more interesting, but more limited example of an archive 
library maintenance construction follows: 

lib: lib(filel.o) lib(file2.o) lib(file3.o) 

S(CC) *-c S(CFLAGS) S(?:.o=.c) 
ar rv lib 8? 

rm 8? ©echo lib is now up to date 

.c.a:; 

Here the substitution mode of the macro expansions is used. The S? list 
is defined to be the set of object file names (inside lib) whose C source 
files are out of date. The substitution mode translates the .o to .c. 
(Unfortunately, one cannot as yet transform to .c~; however, this may 
become possible in the future.) Note also, the disabling of the .c.a: rule, 
which would have created each object file, one by one. This particular 
construct speeds up archive library maintenance considerably. This type 
of construct becomes very cumbersome if the archive library contains a 


Page 5 


February 20, 1984 







MAKE(l) 


MUNIX 


MAKE(l) 


mix of assembly programs and C programs. 

FILES 

[Mm]akefile 

s.[Mm]akefile 

SEE ALSO 

sh(l). 

Make—A Program for Maintaining Computer Programs by S. I. Feldman. 

An Augmented Version of Make by E. G. Bradford. 

BUGS 

Some commands return non-zero status inappropriately; use — i to over¬ 
come the difficulty. Commands that are directly executed by the shell, 

notably cd(l), are ineffectual across new-liries in make. The syntax 
(lib(filel.o file2.o file3.o) is illegal. You cannot build lib(file.o) from file.o. 
The macro S(a:.o=.c~) doesn’t work. 
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NAME 

man, manprog — print entries in this manual 
SYNOPSIS 

man [ options ] [ section ] titles 


/usr/lib/manprog file 
DESCRIPTION 

Man locates and prints the entry of this manual named title in the 
specified section. (For historical reasons, the word "page” is often used 
as a synonym for "entry" in this context.) The title is entered in lower 
case. The section number may not have a letter suffix. If no section is 
specified, the whole manual is searched for title and all occurrences of it 
are printed. Options and their meanings are: 


—t Typeset the entry in the default format (8.5"xi l"). 

—s Typeset the entry in the small format (6''x9"). 

—T4014 Display the typeset output on a Tektronix 4014 terminal usine 

fc(D. 

—Ttek Same as —T4014. 

—Tst Print the typeset output on the MHCC STARE facility (this option 

is not usable on most systems). 

-Tvp Print the typeset output on a Versatec printer; this option is 
not available at all UNIX System site$. 

—Tferrn Format the entry using nroff and print it on the standard out¬ 
put (usually, the terminal); term is the terminal type (see 
ferm(7) and the explanation below); for a list of recognized 
values of term, type help term2. The default value of ferrn is 
450. 


—w Print on the standard output only the path names of the 

entries, relative to /usr/man, or to the current directory for 
—d option. 

—d Search the current directory rather than /usr/man; requires 

the full file name (e.g., cu.lc, rather than just cu). 

—12 Indicates that the manual entry is to be produced in 12-pitch. 

May be used when STERM (see below) is set to one of 300, 300s, 
450, and 1620. (The pitch switch on the DASI 300 and 300s ter¬ 
minals must be manually set to 12 if this option is used.) 

-c Causes man to invoke cof(l); note that cof(l) is invoked 

automatically by man unless term is one of 300, 300s, 450 37 
4000a, 382, 4014, tek, 1620, and X. 

—y Causes man to use the non-compacted version of the macros. 

The above options other than —d, —c, and —y are mutually exclusive, 
except that the —s option may be used in conjunction with the first four 
—T options above. Any other options are passed to troff, nroff, or the 
man(7) macro package. 


When using nroff, man examines the environment variable STERM (see 
environ{ 7)) and attempts to select options to nroff, as well as filters, that 
adapt the output to the terminal being used. The —T term option over¬ 
rides the value of STERM; in particular, one should use —Tip when sending 
the output of man to a line printer. 
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Section may be changed before each title. 

As an example: 

man man 

would reproduce on the terminal this entry, as well as any other entries 
named man that may exist in other sections of the manual, e.g., man(7). 

If the first line of the input for an entry consists solely of the string: 

•V x 

where x is any combination of the three characters c, e, and t, and where 
there is exactly one blank between the double quote (") and x, then man 
will preprocess its input through the appropriate combination of cui(l), 

egn(l) (negn for nroff) and t6f(l), respectively; if egn or negn are 
invoked, they will automatically read the file /usr/pub/eqnchar (see 
eqnch.ar(7)). 

The man command executes manprog that takes a file name as its argu¬ 
ment. Manprog calculates and returns a string of three register 
definitions used by the formatters identifying the date the file was last 
modified. The returned string has the form: 

—rd day —rmmonth —ryyear 

and is passed to nroff which sets this string as variables for the man 
macro package. Months are given from 0 to 11, therefore month is 
always 1 less than the actual month. The man macros calculate the 
correct month. If the man macro package is invoked as an option to 
nroff/troff (i.e., nroff —man file), then the current day/month/year is 
used as the printed date. 

FILES 

/usr/man/man[l-8]/* the UNIX System User’s Manual 

/usr/man/local/man[l-8]/* local additions 

/usr/lib/manprog calculates modification dates of entries 

SEE ALSO 

cw(l), eqn(l), nroff(l), tbl(l), tc(l), troff(l), environ(7), man(7), term(7). 

BUGS 

All entries are supposed to be reproducible either on a typesetter or on a 
terminal. However, on a terminal some information is necessarily lost. 
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NAME 

man — print sections of this manual 
SYNOPSIS 

man [ option ... ] [ chapter ] title ... 

DESCRIPTION 

Man locates and prints the section of this manual named title in the 
specified chapter. (In this context, the word ’page’ is often used as a 
synonym for •section 1 .) The title is entered in lower case. The chapter 

number does not need a letter suffix. If no chapter is specified, the whole 
manual is searched for title and all occurrences of it are printed. 

Options and their meanings are: 

—t Phototypeset the section using troff{l). 

—n Print the section on the standard output using nroff(l). 

“ k Display the output on a Tektronix 4014 terminal using troff(l) and 

—e Appended or prefixed to any of the above causes the manual sec¬ 

tion to be preprocessed by neqn or egn(l); —e alone means -te. 

—w Print the path names of the manual sections, but do not print the 

sections themselves. 

(default) 

Copy an already formatted manual section to the terminal, or, if 
none is available, act as -n. It may be necessary to use a filter to 
adapt the output to the particular terminal's characteristics. 

Further options, e.g. to specify the kind of terminal you have, are passed 
on to troff{l) or nroff. Options and chapter may be changed before each 
title . 

For example: 

man man 

would reproduce this section, as well as any other sections named man 
that may exist in other chapters of the manual, e.g. man(7). 

FILES 

/usr/man/man?/* 

/usr/man/cat?/* 

SEE ALSO 

nroflf(l), eqn(l), tc(l), man(7), catman(8) 

BUGS 

The manual is supposed to be reproducible either on a phototypesetter 
or on a terminal. However, on a terminal some information is necessarily 
lost. 
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NAME 

med — screen editor 
SYNOPSIS 

med file [startline] [searc/iJbey] 

med - 

med 

DESCRIPTION 

Med calls the MED editor, which allows you to edit a file using the screen 
of your terminal and the cursor keys, somewhat like paper, pencil and 
eraser. 

If you call the editor by med file, the first lines of the file will be shown on 

the terminal screen. If the file does not exist, it will be created. 

Med called with no arguments continues where the previous med session 
ended. 

Med called with argument restores only one file from the last session. 


The purpose of a screen editor is to create a new file, or to look at and 
change existing files. Med allows you to look through a file by moving a 
"window’' (the text shown at the screen) over the files contents. The win¬ 
dow may be moved up. down, to the left or the right. The "cursor" (a 
blinking underline or box) shows where med is at the moment. Initially 
med is in "replace mode", i.e. the characters typed will replace those 
under^the cursor. The cursor may be moved around with the arrow keys 
E 0 E 0 or with Ireturnl . |home| or fCaUI . 

To change text on the screen, the cursor has to be placed there and the 
new characters entered. Ideichl deletes the character under the cursor. 
To inse rt characters in the middle of a word (like a’d’ in ’midle’), press 
|insert| ; then new characters w ill be in serted, and the rest of the line will 
move to the right. Pressing jinsertl again, med is switched back to 
"replace mode". 


"Function keys" are special keys along the top or the right of the key¬ 
board. Each function key does one job, such as moving some lines, look¬ 
ing for a word, or using another file. A picture of all the different func¬ 
tion keys for your terminal should be attached to this description. 

Some functions take arguments such as a number, a search string, a file 
name, etc. T o enter an argument, type the sequence: 

_ lenterl number or string function] . 

lenterl leaves an marker on the screen to remind you where the cur¬ 
sor was. It then goes to the bottom line on the screen to read the argu¬ 
ment. This bottom line is also used to display error messages. 
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Function keys and their meaning 
Move around: 


t 4 

Move cursor 

±tab 

Skip to next/previous tab stop 

±page 

Move to next/previous page 

±line 

Move a halfpage up/down 

isearch 

Search for a word 

goto 

Goto line n 

left 

Move window left 

right 

Move window right 

Use another f 

ile or window: 

use 

Use another file 

window 

Create/delete a window 

chwin 

Go to next window 

Cut and paste: 

backspace 

Delete character left of cursor 

close 

Delete line(s) into CLOSE buffer 

delch 

Delete character 

open 

Insert blank line(s) 

pick 

Copy text to PICK buffer 

put 

Get text from PICK buffer 

restore 

Get text from CLOSE buffer 

Others: 

do 

Run a Unix command 

enter 

Enter a parameter 

exit 

Go back to Unix 

insert 

Flip insert mode 

quote 

Control character escape 

refresh 

Refresh 

save 

Write changes to disk 

chtabs 

Change tabs 

macro 

collect keystrokes 


[enter! n Move the cursor n lines/columns in the direction of the 

arrow. 
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1 backspacel 


|chtab| 

|enter||chtab| 


Remove the last character entered; thus typing 

*'E R X | backspace] R" is the same as "E R R". This also 

works in insert mode. 

Set a tab stop at the current position. 

Remove the tab stop at the current position. 


[chwin] 

fenterl n ichwinj 
;enter ?.«--» Ichwini 


Go to the next window. 

Go to window n. Windows are numbered in the order they 
are created. 

Argument defined by the cursor is used as window 
number. 


close! 


enter! [close! 


enter! n Iclosel 
enter! |close| 


[cTefch'l 


do! 

enterj Idol 
|enter| cmd idol 


I exit | 


a j exit | 
ad |exit! 


]g° lo l 


enter 

J lg°to| 

enter 

| n I'gotol 

enter 

] ti*--* fgoto| 


[insert! 


Delete one line. It is saved in the CLOSE buffer. 

Delete the rest of the line, replacing it with the line below. 
Delete n lines and save them in the CLOSE buffer. 

Delete lines or a rectangle defined by the cursor and put 
it into the CLOSE buffer. 

Delete the character at the current cursor position, mov¬ 
ing the following characters to the left. 

Run the previous DO command exactly as it was given. 
Take the current line as a command for the shell. Results 
are inserted below the current line. 

cmd is a Unix command in the format [n[l]] prg [arg...] (in 
shell notation). It replaces n paragraphs (or n lines if 1 
appears) by the result of running filter prg on that text 
with given args. The replaced paragraphs are saved in the 
CLOSE buffer. 

Exit med, writing back the changed files to disk (a backup 
file named *.6aJk is created). 

Exit, but do not save files. 

Terminate with core dump. 

Move window to top of file. 

Move window to end of file. 

Move to the nth line. 

Argument defined by the cursor is used as line number. 

Put the editor into insert mode. Subsequent characters 
are inserted at the cursor, i.e., characters to the right of 
the cursor are not replaced but moved to the right. 
Pressing |insert! again will place med back to replace 
mode. 
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enter 


enter 


Qerg 

n llefti 


Move window left (about a 1/3 window width). 

Make the current column the last one (if possible). 
Move window n columns left. 


|-Hine| 

lenterlRlinel 

[enter! n | + line 


-ime' 

enter; 

(-line 

enteri 

n l-iine. 

open! 


enter 

lopenl 

enter 

n lopenl 

enter 

U«--» [open! 


Move window down (about 1 /3 page). 

Make the current line the top one. 

Move window down n lines. 

Move window up (about 1/3 page). 

Make the current line the bottom one (if possible). 

Move window up n lines. 

Open up one blank line. 

Split the line exactly at cursor position. 

Open up for n blank lines. 

Insert blank lines or rectangle in area defined by cursor. 


+page| 

enter! n |+page| 


Move window down one page (page = size of window). 
Move down n pages. 


-page 

enter 


n l-pagel 


Move window up one page. 
Move up n pages. 


pick! 

enter! n !pick| 
enter! H«--» !pick) 


Put the current line into the PICK buffer. 

Put n lines into the PICK buffer. 

Place lines or rectangle defined by cursor in PICK buffer. 


[put! 

jenterl n lput| 
enter! U*--» fpuT] 


Insert the contents of the PICK buffer (i.e. the lines or 
rectangle last "picked") at the current position. 

Insert n copies of the PICK buffer at the current position. 
Argument defined by the cursor is used as number of 
copies. 


Iquotel 


[refresh] 


To put a control character into the file, [quote! echoes as 
a and whatever key on the keyboard you press next 
appears as some printable character. The two characters 
now behave as two characters on the screen, but they are 
really the single control character in the file. Changing 
the second letter changes the control character; chang¬ 
ing the preceding mark results in two ordinary charac¬ 
ters. 

Redraw terminal display. 


restore! 


lenterj n |restore| 


Insert the contents of the CLOSE buffer (i.e. the lines or 
rectangle last deleted). Insertion is done at the current 
position. 

Insert n copies of the CLOSE buffer at the current posi- 
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|enter[ [restore] 


tion. 

Argument defined by the cursor is used as number of 
copies. 


right! 


enter! fright! 
enter! n |right! 


Move window right (about a 1/3 window width). 
Make current column the first one. 

Move window right n columns. 


I savel 

[enter name save! 


ienter -» save, 


Save the file shown in the current window. 

Save the file shown in the current window under filename 

name 

Argument defined by the cursor is used as filename. 


1+searcK] 


enter||+search| 

enter! word 
enter) U«--» 

+search| 

+search| 


Search forwards (from the cursor towards the end of the 
file) for an occurrence of the search key last used. 

Search key used is from cursor position up to next blank. 
Search for the next occurrence of word. 

Argument defined by the cursor is used as search key. 


|-search] 


enterli-searchl 

enter! word 
enter! 

-search! 

-search! 


Search backwards (from the cursor towards the beginning 
of the file) for an occurrence of the search key last used. 
Search key used is from cursor position up to next blank. 
Search for the next occurrence of word. 

Argument defined by the cursor is used as search key. 


use| 

enierjfusel 
1 enter! name |use[ 


[enter! t±«--* |use| 


Switch to the file previously used. 

Edit file, taking its name from cursor position up to next 
blank. 

Make the current window look at file name. A linenumber 
and/or searchkey can be specified (as in the med com¬ 
mand). 

Argument defined by the cursor is used as filename. 


|window! Make another window on the real screen, so that you now 

havp two. or three, or more windows. A "default file" is 
used. It may be set to look at a file using fusel . and all 
other functions work within this little window. If the cur¬ 
sor is on the first or last column of your window the line 
separating the two windows goes horizontally on the line 
where the cursor is. The separating line goes vertically if 
the cursor is on the first or last line of your window. You 
may have two windows looking at the same file. In fact, it 
is rather neat, since changes made by editing in either 
window are reflected (at reasonable intervals) in the 
_other window. 

|enterjfwmdow| Delete last created window and return to the previous 

_ one. 

I e nterj name |window] Create another window displaying file name. 
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MACRO 

Typing_ 

Imacroj keystrokes Imacroj key 

stores the keystrokes sequence into the key. To avoid trouble, key can 
only be a printable character. From now on pressing the key is 
equiv alent to typing the (long) keystrokes sequence. The sequence 

Imacrolfmacrol key 

restores the original function of the key. 

Miscellaneous 

What do the funny characters in the margins mean? 

| is normal. 

; means this is past the end of the file. You may still type stuff - 
there just wasn’t anything there before. Even if you type some¬ 
thing on a line, the character won’t go away until the line is rewrit¬ 
ten by the editor - but the stuff is still there. 

< There is still more text to the left (may be blanks). 

> There is still more text to the right (not only blanks). 

When editing a file for which you don’t have write permission, the 
appropriate editor functions will be disabled. 

What to do when disaster comes: 

You are protected from loss of files by the insurance system of the MED 
editor. If you edit a file named foo, the old file foo is renamed foo.bak 
(the old foo.bak is deleted). If you do not like the results of your edit, the 
UNIX command: 

mv foo.bak foo 
restores the original file foo. 

FILES 

/tmp/MED* temporary workfile (PICK- and CLOSE-buffer) 

SSAVE/MED* saves state of editing session 
/usr/lib/med/default default file 
*.bak backup files 

SEE ALSO 

termcap(5), curses(3), keycap(5) 

AUTHOR 

Dittmar Krall, Wolfratshausen, Germany. 

Inspired by the RAND Editor, Steve Zucker e.a., Santa Monica, California. 

BUGS 

Editor crashes can leave your terminal in a strange state, e.g. with dis¬ 
abled keyboard. Your system administrator should have a command to 
enable the keyboard. My panic solution is to switch terminal off/on in 
order to continue. 
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NAME 

mesg - permit or deny messages 

SYNOPSIS 

mesg [ n ] [ y ] 

DESCRIPTION_ _ 

Mesg with argument n forbids messages via write{\) by revoking non-user 
write permission on the user's terminal. Mesg with argument y reinstates 
permission. All by itself, mesg reports the current state without chang¬ 
ing it. 

FILES 

/dev/tty* 

/dev 

SEE ALSO 

write(l) 

DIAGNOSTICS 

Exit status is 0 if messages are receivable, 1 if not, 2 on error. 
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NAME 

mkdir — make a directory 

SYNOPSIS 

mkdir dirname ... 

DESCRIPTION 

Mkdir creates specified directories in mode 777, as modified by umask{Z). 
Standard entries, for the directory itself, and *..* for its parent, are 

made automatically. 

Mkdir requires write permission in the parent directory. 

SEE ALSO 

rm( 1) 

DIAGNOSTICS 

Mkdir returns exit code 0 if all directories were successfully made. Oth¬ 
erwise it prints a diagnostic and returns nonzero. 


I 
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NAME 

mkstr — create an error message file by massaging C source 
SYNOPSIS 

mkstr [ — ] messagefile prefix file ... 

DESCRIPTION 

Mkstr is used to create files of error messages. Its use can make pro¬ 
grams with large numbers of error diagnostics much smaller, and reduce 
system overhead in running the program as the error messages do not 

have to be constantly swapped in and out. 

Mkstr will process each of the specified files, placing a massaged version 
of the input file in a file whose name consists of the specified prefix and 
the original name. A typical usage of mkstr would be 

mkstr pistrings xx *.c 

This command would cause all the error messages from the C source files 
in the current directory to be placed in the file pistrings and processed 
copies of the source for these files to be placed in files whose names are 
prefixed with xx. 

To process the error messages in the source to the message file mkstr 
keys on the string , error('" in the input stream. Each time it occurs, the 
C string starting at the "" is placed in the message file followed by a null 
character and a new-line character; the null character terminates the 
message so it can be easily used when retrieved, the new-line character 
makes it possible to sensibly cat the error message file to see its con¬ 
tents. The massaged copy of the input file then contains a Iseek pointer 
into the file which can be used to retrieve the message, i.e.: 

char efilname[] = ''/usr/lib/pi_strings"; 
int efil = -1; 

error(al, a2. a3, a4) 

i 

char buf[256]; 

if (efil < 0) { 

efil = open(efilname, 0); 
if (efil < 0) { 

oops: 

perror(efilname); 

exit(l); 

I 

I 

if (lseek(efil, (long) al, 0) || read(efil, buf, 256) <= 0) 
goto oops; 

printf(buf, a2, a3, a4); 

I 

The optional — causes the error messages to be placed at the end of the 
specified message file for recompiling part of a large mJfcsfred program. 
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SEE ALSO 

lseek(2), xstr(l) 

AUTHORS 

William Joy and Charles Haley 
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NAME 

mm — print out documents formatted with the MM macros 
SYNOPSIS 

mm [ options ] [ files ] 

DESCRIPTION 

Mm can be used to type out documents using nroff(l) and the MM text- 
macro package. It has options to specify preprocessing by 
ffei(l) and/or neqn(l) and postprocessing by various terminal-oriented 
output filters. The proper pipelines and the required arguments and 
fiags for nr off (i) and MM are generated, depending on the options 
selected. 

Cptions for mm are given below. Any other arguments or flags (e.g., 

—rC3) are passed to nro^(I) or to MM. as appropriate. Such options can 
occur in any order, but they must appear before the files arguments If 
no arguments are given, mm prints a list of its options. 

-Tterm Specifies the type of output terminal; for a list of recognized 
values for term, type help terrn2. If this option is not used, mm 
will use the value of the shell variable STERM from the environ¬ 
ment (see profile(5) and environ(7)) as the value of term, if 
ITERM is set; otherwise, mm will use 450 as the value of term. If 
several terminal types are specified, the last one takes pre¬ 
cedence. 

—12 Indicates that the document is to be produced in 12-pitch. May 
be used when STERM is set to one of 300, 300s, 450, and 1620. 
(The pitch switch on the DASI 300 and 300s terminals must be 
manually set to 12 if this option is used.) 

-c Causes mm to invoke coi(l); note that cof(l) is invoked automat¬ 
ically by mm unless term is one of 300, 300s, 450, 37, 4000A. 382 
4014, tek, 1620, and X 
—e Causes mm to invoke negn(l). 

—t Causes mm to invoke fM(l). 

—E Invokes the —e option of nroff(l). 

—y Causes mm to use the non-compacted version of the macros (see 

mm(7)). 

As an example (assuming that the shell variable STERM is set in the 
environment to 450), the two command lines below are equivalent: 

mm —t — rC3 —12 ghh* 

tbl ghh* | nrofl -cm —T450-12 -h -rC3 

Mm reads the standard input when — is specified instead of any file 
names. (Mentioning other files together with — leads to disaster.) This 
option allows mm to be used as a filter, e.g.: 

cat dws | mm — 

HINTS 

1. Mm invokes nroff(l) with the -h flag. With this flag, nroff(l) 
assumes that the terminal has tabs set every 8 character posi¬ 
tions. 

2. Use the —o list option of nroff( 1) to specify ranges of pages to be 
output. Note, however, that mm, if invoked with one or more of 
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the —e, —t, and — options, together with the —© List option of 
nroj7(l) may cause a harmless "broken pipe” diagnostic if the last 
page of the document is not specified in list. 

3. If you use the —a option of nroff{\) (to stop between pages of out¬ 
put). use line-feed (rather than return or new-line) to restart the 
output. The —s option of nroff{ l) does not work with the —c option 
of mm, or if mm automatically invokes cof(l) (see —c option 
above). 

4. If you lie to mm about the kind of terminal its output will be 
printed on, you’ll get (often subtle) garbage; however, if you are 
redirecting output into a file, use the —T37 option, and then use 
the appropriate terminal filter when you actually print that file. 

SEE ALSO 

col(l), env(l), eqn(l), greek(l), mmt(l), nroff(l), tbl(l), profile(5), mm(7), 

term(7). 

MM—Memorandum Macros by D. W. Smith and J. R. Mashey. 

Typing Documents with MM by D. W. Smith and E. M. Piskorik. 

DIAGNOSTICS 

"mm: no input file" if none of the arguments is a readable file and mm is 

not used as a filter. 
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NAME 

mmchek — check usage of mm macros and eqn delimiters 
SYNOPSIS 

mmchek [files] 

DESCRIPTION _ 

Mmchek is a program for checking the contents of the named files for 
errors in the use of Memorandum Macros (see mm(l)) and some eqn(i) 
constructions. Appropriate messages are produced. The program skips 
ali Rectories, and if no file name is given, standard input is read. 

SEE ALSO 

eqn(l), mm(l), mmt(l). 

MM—Memorandum Macros by D. W. Smith and J. R. Mashey. 

DIAGNOSTICS 

Unreadable files cause the message "Cannot open file-name The 
remaining output of the program is diagnostic of the source file. 

BUGS 

This is an experimental version of mmchek. Mmchek may be fully sup¬ 
ported in the future. 
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NAME 

mmt, mvt - typeset documents, view graphs, and slides 
SYNOPSIS 

mmt [ options ] [ files ] 
mvt [ options ] [ files ] 

DESCRIPTION 

These two commands are very similar to m7n(l), except that they both 
typeset their input via troff{ l), as opposed to formatting it via nrcff{ l); 
rimf uses the MM macro package, while mvt uses the Macro Package for 
view Graphs and Slides. These two commands have options to specify 
preprocessing by tbl{ 1) and/or egn(l). The proper pipelines and the 
required arguments and flags for troff(l) and for the macro packages are 
generated, depending on the options selected. 

Options are given below. Any other arguments or flags (e.g., -rC3) are 
passed to troff{\) or to the macro package, as appropriate. Such options 
can occur in any order, but they must appear before the files arguments 
If no arguments are given, these commands print a list of their options. 

Causes these commands to invoke eqn( l). 

Causes these commands to invoke tbl(l). 

Directs the output to the MH STARE facility. 

Directs the output to a Tektronix 4014 terminal via the <c(l) 
filter. ' 

Same as —T4014. 

Invokes the —a option of troff(l). 

Causes mmt to use the non-compacted version of the macros 
(see mm(7)). No effect for mvt. 

These commands read the standard input when - is specified instead of 
any file names. 

Mvt is just a link to mmt. 

Use the —olist option of trojf(l) to specify ranges of pages to be output. 
Note, however, that these commands, if invoked with one or more of the 
-e. -t, and - options, together with the -olist option of froj^(l) may 
cause a harmless -broken pipe” diagnostic if the last page of the docu¬ 
ment is not specified in list. 

SEE ALSO 

mv^V' eqn(1)l tbl ^)* tc (0. troff(l). profile(5), environ(7), mm(7), 

MM-Memorandum Macros by D. W. Smith and J. R. Mashey. 

Typing Documents with MM by D. W. Smith and E. M. Piskorik. 

A Macro Package for View Graphs and Slides by T. A. Dolotta and D. W 
Smith (in preparation). 

DIAGNOSTICS 

"m[mv]t: no input file" if none of the arguments is a readable file and 
the command is not used as a filter. 


-t 
—Tst 
-T4014 

—Ttek 
—a 

-y 


HINT 
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NAME 

more, page — file perusal filter for crt viewing 
SYNOPSIS 

more [ -cdflsu ] [ -n ] [ +linenumber ] [ +/pattern ] [ name ... ] 

page more options ~~ — --- --- 

DESCRIPTION 

More is a filter which allows examination of a continuous text one screen¬ 
ful at a time on a soft-copy terminal. It normally pauses after each 
screenful, printing -Wore- at the bottom of the screen. If the user then 
types a carriage return, one more line is displayed. If the user hits a 
space, another screenful is displayed. Other possibilites are enumerated 
later. 

The command line options are: 

—n An integer which is the size (in lines) of the window which more will 

use instead of the default. 

—c More will draw each page by beginning at the top of the screen and 

erasing each line just before it draws on it. This avoids scrolling 
the screen, making it easier to read while more is writing. This 
option will be ignored if the terminal does not have the ability to 
clear to the end of a line. 

—d More will prompt the user with the message "Hit space to continue, 

Rubout to abort" at the end of each screenful. This is useful if 
more is being used as a filter in some setting, such as a class, 
where many users may be unsophisticated. 

—f This causes more to count logical, rather than screen lines. That 

is, long lines are not folded. This option is recommended if nroff 
output is being piped through ul, since the latt*er may generate 
escape sequences. These escape sequences contain characters 
which would ordinarily occupy screen postions, but which do not 
print when they are sent to the terminal as part of an escape 
sequence. Thus more may think that lines are longer than they 
actually are, and fold lines erroneously. 

—1 Do not treat “'L (form feed) specially. If this option is not given, 
more will pause after any line that contains a ~L. as if the end of a 
screenful had been reached. Also, if a file begins with a form feed, 
the screen will be cleared before the file is printed. 

—s Squeeze multiple blank lines from the output, producing only one 

blank line. Especially helpful when viewing nroff output, this 
option maximizes the useful information present on the screen. 

—u Normally, more will handle underlining such as produced by nroff 

in a manner appropriate to the particular terminal: if the termi¬ 
nal can perform underlining or has a stand-out mode, more will 
output appropriate escape sequences to enable underlining or 
stand-out mode for underlined information in the source file. The 
—u option suppresses this processing. 

+linenumber 

Start up at linen-umber. 
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+ /pattern 

Start up two lines before the line containing the regular expres¬ 
sion pattern. 

If the program is invoked as page, then the screen is cleared before each 
screenful is printed (but only if a full screenful is being printed), and k — 
1 rather than k — 2 lines are printed in each screenful, where k is the 

number of lines the terminal can display. 

More looks in the file /etc/termcap to determine terminal characteris¬ 
tics. and to determine the default window size. On a terminal capable of 
displaying 24 lines, the default window size is 22 lines. 

More looks in the environment variable MORE to pre-set any flags desired. 

For example, if you prefer to view files using the —c mode of operation, 
the csh command setenv MORE-c or the sh command sequence MORE = -c' 
; export MORE would cause all invocations of more , including invocations 
by programs such as man and msgs , to use this mode. Normally, the 
user will place the command sequence which sets up the MORE environ¬ 
ment variable in the .cshrc or .profile file. 

If more is reading from a file, rather than a pipe, then a percentage is 
displayed along with the --More-- prompt. This gives the fraction of the 
file (in characters, not lines) that has been read so far. 

Other sequences which may be typed when more pauses, and their 
effects, are as follows (i is an optional integer argument, defaulting to 1) : 

i<space> 

display i more lines, (or another screenful if no argument is given) 

~D display 11 more lines (a "scroll”). If i is given, then the scroll size 
is set to i. 

d same as ~D (control-D) 

iz same as typing a space except that i, if present, becomes the new 
window size. 

is skip i lines and print a screenful of lines 

if skip i screenfuls and print a screenful of lines 

q or Q Exit from more. 

= Display the current line number, 

v Start up the editor vi at the current line, 

h Help command; give a description of all the more commands, 

i/expr 

search for the i-th occurrence of the regular expression expr. If 
there are less than i occurrences of expr , and the input is a file 
(rather than a pipe), then the position in the file remains 
unchanged. Otherwise, a screenful is displayed, starting two lines 
before the place where the expression was found. The user's erase 
and kill characters may be used to edit the regular expression. 
Erasing back past the first column cancels the search command. 

in search for the i-th occurrence of the last regular expression 
entered. 
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(single quote) Go to the point from which the last search started 
If no search has been performed in the current file, this command 
goes back to the beginning of the file. 

Icoramand 

invoke a shell with command. The characters and T in "com¬ 
mand" are replaced with the current file name and the previous 
shell command respectively. If there is no current file name, is 
not expanded. The sequences "\%" and "\!” are replaced by 

and "! M respectively. 

i:n skip to the i-th next file given in the command line (skips to last 
file if n doesn't make sense) 

i:p skip to the i-th previous file given in the command line. If this 
command is given in the middle of printing out a file, then more 
goes back to the beginning of the file. If i doesn’t make sense 
more skips back to the first file. If more is not reading from a file! 
the bell is rung and nothing else happens. 

:f display the current file name and line number. 

:q or :Q 

exit from more (same as q or Q). 

(dot) repeat the previous command. 

The commands take effect immediately, i.e., it is not necessary to type a 
carriage return. Up to the time when the command character itself is 
given, the user may hit the line kill character to cancel the numerical 
argument being formed. In addition, the user may hit the erase charac¬ 
ter to redisplay the --More—(xx%) message. 

At any time when output is being sent to the terminal, the user can hit 
the quit key (normally control-\). More will stop sending output, and 
will display the usual —More— prompt. The user may then enter one of 
the above commands in the normal manner. Unfortunately, some output 
is lost when this is done, due to the fact that any characters waiting in 
the terminal’s output queue are flushed when the quit signal occurs. 

The terminal is set to noecho mode by this program so that the output 
can be continuous. What you type will thus not show on your terminal, 
except for the / and ! commands. 

If the standard output is not a teletype, then more acts just like caf, 
except that a header is printed before each file (if there is more than 
one). 

A sample usage of more in previewing nroff output would be 
nroff —ms +2 doc.n | more -s 

AUTHOR 

Eric Shienbrood, minor revisions by John Foderaro and Geoffrey Peck 

FILES 

/etc/termcap Terminal data base 

/usr/lib/more.help Help file 

SEE ALSO 

csh(l), man(l), msgs(l), script(l), sh(l), environ(7) 
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NAME 

msgs — system messages and junk mail program 
SYNOPSIS 

msgs [ —fhlpq ] [ number ] [ —number ] 

DESCRIPTION 

Msgs is used to read system messages. These messages are sent by mail¬ 
ing to the login 'msgs' and should be short pieces of information which 
are suitable to be read once by most users of the system. 

Msgs is normally invoked each time you login, by placing it in the file 
.Login (.profile if you use /bin/sh). It will then prompt you with the 
source and subject of each new message. If there is no subject line, the 

first few non-blank lines of the message will be displayed. If there is 
more to the message, you will be told how long it is and asked whether 
you Vish to see the rest of the message. The possible responses are: 

y type the rest of the message 

RETURN 

synonym for y. 

n skip this message and go on to the next message. 

— redisplay the last message. 

q drops you out of msgs; the next time you run the program it will 
pick up where you left off. 

s append the current message to the file "Messages" in the current 
directory; *s—' will save the previously displayed message. A ‘s’ or 
*s—' may be followed by a space and a filename to receive the mes¬ 
sage replacing the default "Messages". 

m or ‘m—’ causes a copy of the specified message to be placed in a 
temporary mailbox and maii(l) to be invoked on that mailbox. 
Both’m' and 's’ accept a numeric argument in place of the 

Msgs keeps track of the next message you will see by a number in the file 
.msgsrc in your home directory. In the directory /usr/msgs it keeps a 
set of files whose names are the (sequential) numbers of the messages 
they represent. The file /usr/msgs/bounds shows the low and high 
number of the messages in the directory so that msgs can quickly deter¬ 
mine if there are no messages for you. If the contents of bounds is 
incorrect it can be fixed by removing it; msgs will make a new bounds file 
the next time it is run. 

Options to msgs include: 

—f which causes it not to say “No new messages.”. This is useful in 

your .login file since this is often the case here. 

—q Queries whether there are messages, printing "There are new mes¬ 

sages.” if there are. The command “msgs — q” is often used in 
login scripts. 

—h causes msgs to print the first part of messages only. 

—1 option causes only locally originated messages to be reported. 
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num A message number can be given on the command line, causing 
msgs to start at the specified message rather than at the next 
message indicated by your .msgsrc file. Thus 

msgs —h 1 

prints the first part of all messages. 

—number 

will cause msgs to start number messages back from the one indi¬ 
cated by your .msgsrc file, useful for reviews of recent messages. 

— p causes long messages to be piped through more(l). 

Within msgs you can also go to any specific message by typing its number 
when msgs requests input as to what to do. 

FILES 

/usr/msgs/* database 

~/.msgsrc number of next message to be presented 

AUTHORS 

■William Joy 
David Wasley 

SEE ALSO 

mail(l), more(l) 
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NAME 

mt — magnetic tape manipulating program 
SYNOPSIS 

mt [ —t tapename ] command [ count ] 

DESCRIPTION_ _ 

Mt is used to give commands to the tape drive. If a tape name is not 
specified, /dev/nrmtO is used. If a count is not specified. 1 is assumed. 

Here are the commands: 

eof write count end-of-file marks 

fsf space forward count files 

fsr space forward count records 

bsf space backward count files 

bsr space backward count records 

rew rewind tape 

ofll rewind tape and go offline 

sw swap bytes 

nsw do not swap bytes 

len read the tape; print size of each record 

FILES 

/dev/rmt* Raw magnetic tape interface 

SEE ALSO 

tm(4), dd(l) 
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NAME 

newgrp — log in to a new group 

SYNOPSIS 

newgrp [ group ] 

Newgrp changes the group identification of its caller, analogously to 
login(\). The same person remains logged in, and the current directory 
is unchanged, but calculations of access permissions to files are per¬ 
formed with respect to the new group ID. 

Newgrp without an argument changes the group identification to the 
group in the password file; in effect it changes the group identification 
back to the caller's original group. 

A password is demanded if the group has a password and the user himself 
does not, or if the group has a password and the user is not listed in 
/etc/group as being a member of that group. 

When most users log in, they are members of the group named other. 


FILES 


/etc/group 

/etc/passwd 


SEE ALSO 

login(l). group(5). 

BUGS 

There is no convenient way to enter a password into /etc/group. 

Use of group passwords is not encouraged, because, by their very nature, 
they encourage poor security practices. Group passwords may disappear 
in the future. 
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NAME 

news — print news items 
SYNOPSIS 

news [ — a ] [ —n ] [ —s ] [ items ] 

DESCRIPTION 

News is used to keep the user informed of current events. By conven¬ 
tion, these events are described by files in the directory /usr/news. 

When invoked without arguments, news prints the contents of all current 
files in /usr/news, most recent first, with each preceded by an appropri¬ 
ate header. News stores the "currency” time as the modification date of 
a file named ,news_time in the user's home directory (the identity of this 
directory is determined by the environment variable JHOME); only files 
more recent than this currency time are considered "current.” 

The —a option causes news to print all items, regardless of currency. In 
this case, the stored time is not changed. 

The —n option causes news to report the names of the current items 
without printing their contents, and without changing the stored time. 

The —s option causes news to report how many.current items exist, 
without printing their names or contents, and without changing the 
stored time. It is useful to include such an invocation of news in one's 
.profile file, or in the system’s /etc/profile. 

All other arguments are assumed to be specific news items that are to be 
printed. 

If a delete is typed during the printing of a news item, printing stops and 
the next item is started. Another delete within one second of the first 
causes the program to terminate. 

FILES 

/etc/profile 

/usr/news/* 

SHOME/ .news_time 

SEE ALSO 

profile(5), environ(7). 

REMARKS 

The USENET news package is also very suitable for local news. It is much 
more powerful than this small news facility (see ineius(l), postnews { l), 
readneu>s(l)). 
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NAME 

nice, nohup — run a command at low priority 
SYNOPSIS 

nice [ -number ] command [ arguments ] 
nohup command [ arguments ] 

DESCRIPTION 

Nice executes command with low scheduling priority. If the number 
argument is present, the priority is incremented (higher numbers mean 
lower priorities) by that amount up to a limit of 20. The default number 

is 10. 

The super-user may run commands with priority higher than normal by 
using a negative priority, e.g. '—10'. 

Nohup executes command immune to hangup and terminate signals from 
the controlling terminal. The priority is incremented by 5. Nohup should 
be invoked from the shell with 'it' in order to prevent it from responding 
to interrupts by or stealing the input from the next person who logs in on 
the same terminal. 

FILES 

nohup.out standard output and standard error file under nohup 

SEE ALSO 

nice(2) 

DIAGNOSTICS 

Nice returns'the exit status of the subject command. 
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NAME 

nl — line numbering filter 
SYNOPSIS 

nl [—htype] [-btype] [— ftype] [-vstart#] [—iincr] [—p] [-lnum] [-ssep] 
[—■wwidth] [—nformat] file 

DESCRIPTION 

Nl reads lines from the named file or the standard input if no file is 
named and reproduces the lines on the standard output. Lines are num¬ 
bered on the left in accordance with the command options in effect. 

Nl views the text it reads in terms of logical pages. Line numbering is 
reset at the start of each logical page. A logical page consists of a 
header, a body, and a footer section. Empty sections are valid. Different 
line numbering options are independently available for header, body, and 
footer (e.g. no numbering of header and footer lines while numbering 
blank lines only in the body). 

The start of logical page sections are signaled by input lines containing 
nothing but the following character(s): 

Line contents Start of 
\:\:\: header 

\:\: body 

\: footer 

Unless signaled otherwise, nl assumes the text being read is in a single 
logical page body. 

Command options may appear in any order and may be intermingled with 
an optional file name. Only one file may be named. The options are: 

—btype Specifies which logical page body lines are to be numbered. 

Recognized types and their meaning are: a, number all lines: t, 
number lines with printable text only; n, no line numbering: 
p string, number only lines that contain the regular expression 
specified in string. Default type for logical page body is t (text 
lines numbered). 

—htype Same as —btype except for header. Default type for logical 
page header is n (no lines numbered). 

—ftype Same as —btype except for footer. Default for logical page 
footer is n (no lines numbered). 

—p Do not restart numbering at logical page delimiters; 

—vstart# Start# is the initial value used to number logical page lines. 
Default is 1. 

—iincr frier is the increment value used to number logical page lines. 
Default is 1. 

—ssep Sep is the character(s) used in separating the line number and 
the corresponding text line. Default sep is a tab. 

—w width. Width is the number of characters to be used for the line 
number. Default width is 6. 


Page 1 


February 17,1984 







NL( 1) 


MUNIX 


NL(1) 


—nformat 

Format is the line numbering format. Recognized values are: In, 


—lnum 

left justified, leading zeroes supressed; m, right justified, lead¬ 
ing zeroes supressed; rz, right justified, leading zeroes kept. 
Default format is m (right justified). 

Num is the number of blank lines to be considered as one. For 
example. —12 results in only the second adjacent blank being 
numbered (if the appropriate —ha, —ba, and/or —fa option is 

set). Default is 1. 

SEE ALSO 

PKI). 
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NAME 

nm — print name list 
SYNOPSIS 

nm [ — gnopru ] [ file ... ] 

DESCRIPTION 

Nm prints the name list (symbol table) of each object file in the argu¬ 
ment list. If an argument is an archive, a listing for each object file in 
the archive will be produced. If no file is given, the symbols in ‘a.out’ are 

listed. 

Each symbol name is preceded by its value (blanks if undefined) and one 
of the letters U (undefined), A (absolute), T (text segment symbol), D 
(data segment symbol), B (bss segment symbol), or C (common symbol). 
If the symbol is local (non-external) the type letter is in lower case. The 
output is sorted alphabetically. 

Options are: 

—g Print only global (external) symbols. 

—n Sort numerically rather than alphabetically. 

—o Prepend file or archive element name to each output line rather 

than only once. 

—p Don't sort; print in symbol-table order. 

—r Sort in reverse order. 

—u Print only undefined symbols. 

SEE ALSO 

ar(l), ar(5), a.out(5) 
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NAME 

notes, autoseq, nfpipe, nfprint, nfstats — a news system 
SYNOPSIS 

notes [ —sxin ] [ —t termtype ] topic 1 [ -if file )[...] 
autoseq 

nfpipe topic [ -t title ] [ -d ] [ -a ] 
nfprint [ -nn ] topic [ note list ) 
nfstats [ -s ] topic [ ... ] 
checknotes [ -qnvs ] 

DESCRIPTION 

Notes supports computer managed discussion forums. It coordinates 

access to and updates of data bases of notes and their responses. A sin¬ 
gle notesfile contains an ordered list of base notes, each of which may 
have an ordered list of responses associated with it. A note string con¬ 
sists of a base note and all of its responses. Separate notesfiles contain 
discussions on separate subject matters; microcomputers might be dis¬ 
cussed in a "micronotes’* notesfile while bicycling enthusiasts make their 
comments in a "bicycle" notesfile. 

The —s option signals notes to use the automatic sequencer. With the 
sequencer enabled, notes shows the new notes and responses since your 
last entry into that notesfile. With the sequencer enabled by —s the 
notes program will not enter notesfiles which have no new text. Specify 
—x to use the sequencer and enter notesfiles even if they have no new 
text. The —i and —n options are still more sequencing modes, —i is similar 
to —s but shows the index page instead of the first modified note. —n 
turns the sequencer off. 

Specify —t termtype to override the TERM environment variable. This 
switch is mostly used on version 6 systems. 

The -f option directs notes to read the contents of a file for a list of 
notesfiles to scan. 

The topic list specifies which notesfiles are to be scanned. The notesfiles 
are scanned from left to right; upon finishing the first topic, the second 
is entered. The shell’s meta-characters are recognized within a topic but 
must be escaped to prevent shell interpretation. Specifying "net.*" will 
yield all the notesfiles with the prefix "net.". Specify "*unix*" to read all 
notesfiles with the string "unix” in their names. Bracket and question 
mark constructs are also recognized. 

The autoseq feature allows sequencing through a list of notesfiles with 
the sequencer enabled using with a single command. The autoseq is 
(almost) syntactically equivalent to "notes -s SNFSEQ" where NFSEQ con¬ 
tains a comma separated list of notesfile names. A typical NFSEQ 
definition for the Bourne shell looks like: 

NFSEQ="general, announce, net. ‘.bicycle,srg". 

Notes and responses are entered by using an editor. The default editor is 
/bin/ed. This can be changed by setting one of the environment vari¬ 
ables NFED or EDITOR. 
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Some commonly used commands within the notesfile system are listed 

below: 


space 

Show the next page of the note/response. 

newline 

Go the next response, if there are no more responses go to the 
next note. 

Go to the previous page of the current note/response. From 
the first page of a response, go to the previous response (or the 
base note from the first response). From the first page of a 

base note, go to the previous note. 

Go to the next note 

J 

Jump to the next unread note/response (when using 
sequencer). 

J 

Jump to the next unread note, ignoring any further responses 
in the current note string (when using sequencer). 

w 

When issued from the index page enters a new note. When 
entered from a note/response display enters a response. A 
capital-W will include the text of the currently displayed 
note/response in the new response. 

q 

Q 

Leave the current notesfile. 

Leave the current notesfile without updating the sequencer 
information. 


control-z 


X 

Return to the shell, ignoring any further notesfiles in the 
current invocation. No sequencer information is updated. 

Search for a note with the (prompted for) string in its title. 
Capital-X asks for a new search string, otherwise the last 
entered string is used. 

s 

Saves the currently displayed note/response at the end of a 
(prompted for) file. Capital-S saves the entire note string. 

M 

Sends the text of the note/response displayed and your com¬ 
ments to another user(s). The P command routes the letter to 
the author of the note/response. 

t 

Issues a write(l) command to the author of the currently 
displayed note/response. No action is taken if the note ori¬ 
ginated on a remote system or is anonymous. 

j 

Forks a shell. 


Nfpipe reads standard input to create a note in the specified notesfile. 
The title of the note is specified using the -t parameter. The -d flag 
specifies that this note is to have the director message flag enabled; if 
the author has no director privileges in the notesfile, this flag has no 
effect. Specifying -a makes the note anonymous; if anonymous notes are 
not permitted this flag has no effect. 

Nfprint gives the user the ability to print the contents of notesfiles. The 
-nn parameter specifies the page length to use (66 lines/page is the 
default). The note list is the set of notes which are to be printed. An 
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example note list is: 1,30-36,13,10,42-50. Nfprint writes to standard out¬ 
put. 

Nfstats prints usage statistics for notesfiles. This program takes a list of 
notesfiles and lists their statistics on standard output. If more than one 
notesfile is specified, an aggregate set of statistics is also produced. 
Specify -s to have only this aggregate report printed and the individual 
reports suppressed. 

Checknotes reports on the existence of new notes. The NFSEQ environ¬ 
ment variable is read to determine the users subscription. Checknotes 
then looks at each of if there are new notes. The various flags specify 
the method of notification. Use -g to have the message "There are new 
notes" printed if this is so. Specify -n to get a message "There are no 
new notes" if this is the case. With the -v option enabled, checknotes 
prints the names of the notesfiles which have new notes in them. The -s 
option is silent; no output is produced. Regardless of the option, the pro¬ 
gram exits with 0 (TRUE) if new notes exist and with 1 (FALSE) if no new 
notes exist. 

An interface is provided to news(l). Transfers in both directions are sup¬ 
ported. See notes(8) for more information on how this works. 

Only the notesfile owner can create new notesfiles. The notesfile owner 
will create the notesfile and turn control over to the person requesting 
the notesfile. This person is the notesfile director; he may designate oth¬ 
ers to also be notesfile directors. The notesfile director has special 
privileges including: deleting any note, determining policy for the 
notesfile, permitting anonymous notes, and determining accessibility of 
the notesfile. 

The concept of a notesfile was taken from the PLATO system (a trade¬ 
mark of Control Data Corporation) designed at the University of Illinois 
to provide automated teaching capabilities. 


BUGS 


Only the name of a note’s originating system is kept; another utility must 
be used to generate paths for mailing to distant (more than 1 hop) 
authors. 

Some of the notesfile programs do not check to make sure the user is not 
the ANONUID user who is not allowed to run nofes; the programs that fail 
to do this are ones which do not allow writing. 

Sometimes interrupting a display with the RUBOUT or DELETE key will 
leave the program in a state where it prints only the first character of 
titles and other headers. 

When more then 128 lines are saved with the "S'' or "s” options of notes, 
the program reports strange values. This is because only 8 bits are avail¬ 
able for passing the result. 


FILES 


/etc/passwd 
/etc/group 
/etc/termcap 
/usr/spool/notes 


for the users name 
for the users group 
for terminal capabilites 
the notesfile data base 
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/usr/spool/notes/. utilities utility programs and online help 

/usr/spool /notes/topic/text text of the notes in notesfile ‘topic’ 

/usr/spool / notes /topic /note.indx 

the note descriptors for notesfile ‘topic 1 

/usr/spool/notes/topic / re sp.indx 

the response descriptors for notesfile 
‘topic’ 

/usr /spool/notes/topic/access the permission list for the notesfile 

‘topic’ 

SEE ALSO 

ed(l), news(l). nfccmment(3), notes(8). termcap(3), write(l). 

The Notesfile Reference Manual 

authors 

Ray Essick (uiucdcslessick, uiucdcslnotes) 

Rob Kolstad (uiucdcslkolstad) 

Department of Computer Science 
222 Digital Computer Laboratory 
University of Illinois at Urbana-Champaign 
1304 West Springfield Ave. 

Urbana, IL 61801 
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NAME 

od — octal dump 
SYNOPSIS 

od [ —bcdox ] [ file ] [ [ + ]offset[ . ][ b ] ] 

DESCRIPTION 

Od dumps file in one or more formats as selected by the first argument. 
If the first argument is missing, —o is default. The meanings of the for¬ 
mat argument characters are: 

b Interpret bytes in octal. 

c Interpret bytes in ASCII. Certain non-graphic characters appear as C 
escapes: null=\0, backspace=\b, formfeed=\f, newline=\n, 

return=\r, tab=\t; others appear as 3-digit octal numbers. 

d Interpret words in decimal, 
o Interpret words in octal, 
x Interpret words in hex. 

The file argument specifies which file is to be dumped. If no file argu¬ 
ment is specified, the standard input is used. 

The offset argument specifies the offset in the file where dumping is to 
commence. This argument is normally interpreted as octal bytes. If V is 
appended, the offset is interpreted in decimal. If *b‘ is appended, the 
offset is interpreted in blocks of 512 bytes. If the file argument is omit¬ 
ted, the offset argument must be preceded 

Dumping continues until end-of-file. 

SEE ALSO 

adb(l),xd(l) 
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NAME 

pack — packs or unpacks many files <—> one. 

SYNOPSIS 

a) pack filel [file2] ... [filen] or 

b) pack 

DESCRIPTION 

a) pack filel ... filen 

packs these files onto stdout. Between the files the following line is 
inserted 

jjv,*.*.****** 

b) pack 

unpacks stdin (a previously packed file) onto the component files. 

Hint: fgrep ’*■[/’ packedfile 

picks out the names of the component files). 

EXAMPLE1 

pack *.p | xref 

makes a cross-reference list of a group of files. 

EXAMPLE2 

pack *.c | sed —f change.sed | pack 
seds a whole group of files at once. 

DIAGNOSTICS 

If file cannot be opened the message 
'cannot open file <file>’ is written on stderr. 

If the inputfile has a bad format the message 

'phase error in line <line number>’ is written on stderr. 
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NAME 

passwd — change login password 

SYNOPSIS 

passwd [ name ] 

DESCRIPTION 

This command changes (or installs) a password associated with the user 
name (your own name by default). 

The program prompts for the old password and then for the new one. 
The caller must supply both. The new password must be typed twice, to 
forestall mistakes. 

New passwords must be at least four characters long if they use a 
sufficiently rich alphabet and at least six characters long if monocase. 
These rules are relaxed if you are insistent enough. 

Only the owner of the name or the super-user may change a password; 
the owner must prove he knows the old password. 

FILES 

/etc/passwd 
SEE ALSO 

login(l). passwd(5), crypt(3C) 

Robert Morris and Ken Thompson, Password Security: A Case History 
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NAME 

paste — merge same lines of several files or subsequent lines of one file 
SYNOPSIS 

paste filel file2 ... 
paste —dlist filel file2 ... 
paste —s [—dlist] filel file2 ... 

DESCRIPTION 

In the first two forms, paste concatenates corresponding lines of the 
given input files filel, file2, etc. It treats each file as a column or 
columns of a table and pastes them together horizontally (parallel merg¬ 
ing). If you will, it is the counterpart of caf(l) which concatenates verti¬ 
cally, i.e., one file after the other. In the last form above, paste subsumes 
the function of an older command with the same name by combining sub¬ 
sequent lines of the input file (serial merging). In all cases, lines are 
glued together with the tab character, or with characters from an 
optionally specified list. Output is to the standard output, so it can be 
used as the start of a pipe, or as a filter, if — is used in place of a file 
name. 

The meanings of the options are: 

—d Without this option, the new-line characters of each but the last 

file (or last line in case of the —a option) are replaced by a tab 
character. This option allows replacing the fob character by one 
or more alternate characters (see below). 

iisf One or more characters immediately following —d replace the 
default fab as the line concatenation character. The list is used 
circularly, i. e. when exhausted, it is reused. In parallel merging (i. 
e. no —s option), the lines from the last file are always terminated 
with a new-line character, not from the itsf. The list may contain 
the special escape sequences: \n (new-line). \t (tab). \\ 
(backslash), and \0 (empty string, not a null character). Quoting 
may be necessary, if characters have special meaning to the shell 
(e.g. to get one backslash, use — <f"\\\V'). 

-s Merge subsequent lines rather than one from each input file. Use 
tab for concatenation, unless a fisf is specified with —d option. 
Regardless of the list, the very last character of the file is forced 
to be a new-line. 

— May be used in place of any file name, to read a line from the stan¬ 
dard input. (There is no prompting). 

EXAMPLES 

Is | paste —d" ” — list directory in one column 

Is | paste- list directory in four columns 

paste -s —d"\ t\ n" file combine pairs of lines into lines 

SEE ALSO 

grep(l), cut(l), 

pr(l): pr —t —m... works similarly, but creates extra blanks, tabs and 
new-lines for a nice page layout. 
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DIAGNOSTICS 

Line too Long Output lines are restricted to 511 characters. 

too many files Except for —s option, no more than 12 input files may 

be specified. 
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NAME 

pc - Pascal compiler 
SYNOPSIS 

pc [ option ] ... file ... 

DESCRIPTION 

pc is the MUNIX Pascal compiler. It accepts several types of arguments: 

Arguments whose names end with ’.p' are taken to be Pascal source pro¬ 
grams; they are compiled, and each object program is left on a file with 
suf'ix '.o'. The '.o’ file is normally deleted, however, if a single Pascal pro¬ 
gram is compiled and loaded all at one go. Errors detected by the com- 
p..er are listed on stdout. This Pascal compiler has the cpp-identifier 
m68000 predefined, i.e. "#ifdef m68000" is true. 

Filenames are built from the basename of the source program and a cer¬ 
tain suffix. 

A call "pc test.p" is the same as "pc -c test.p ScSc Id /lib/prtO.o test.o -lffp 
-lp -lc Sc&c rm test.o". The call "pc *.o" is the same as "Id /lib/prtO.o *.o 
-lffp -lp -lc". If your directory contains the file xyz.p, a call "make xyz" 
will result in "pc -o xyz xyz.p". 

The following options are interpreted by pc. See fd(l) for load options. 

—c Suppress the loading phase of the compilation, and force an 

object file to be produced even if only one program is compiled. 

—d Switch on the debug mode. 

—e Display extension warning messages to stdout. 

—m Load new, mark Sc release instead of new Sc dispose. 

-n Suppress execution (“dry run”) of pc commands. 

—o output 

Name the final output file output. If this option is used the file 
’a.out’ will be left undisturbed. This option is passed on to the 
linker. 

—p Arrange for the compiler to produce code which counts the 

number of times each routine is called; also, if loading takes 
place, replace the standard startup routine by one which 
automatically calls monitor(3C) at the start and arranges to write 
out a mon.out file at normal termination of execution of the 
object program. An execution profile can then be generated by 
use of pro/(l). 

—1[ 12] Find only the designated compiler passes in the files whose names 
are constructed by a —B option. In the absence of a —B option, 
the string is taken to be '/usr/src/cmd/pc/o'. 

—w Display warning messages to stdout. 

—Bstring 

Find substitute compiler passes in the files named string with the 
suffixes passl and pass2. If string is empty, use a standard 
backup version. 
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—Dname=def 

-Dnamc 

Define the name to the preprocessor, as if by ’#define’. If no 
definition is given, the name is defined as 1. 

—Idir Files of ’^include’ type whose names do not begin with ’/’ are 
always sought first in the directory of the file argument, then in 
directories named in —I options, then in directories on a standard 

list. 

—L Additionally generates listings on corresponding files suffixed \1\ 

-P Run only the macro preprocessor and place the result for each 
'.p file in a corresponding ’.i’ file and has no lines in it. 

—S Compile the named Pascal programs and leave the assembler- 

language output on corresponding files suffixed ’.s’. 

—T Trace and print pc commands. Temporary files are not deleted. 


—Uname 

Remove any initial definition of name. 

Other arguments are taken to be either loader(ld) option arguments, or 
Pascal-compatible object programs, typically produced by an earlier pc 
run, or perhaps libraries of Pascal-compatible routines. These programs, 
together with the results of any compilations specified, are loaded (in the 
order given) to produce an executable program with name a.out. 


FILES 

file.i 

file.l 

file.o 

file.p 

file.s 

a.out 

/tmp/ptm* 

/lib/cpp 

/lib/pass[l2j 

/lib/c2 

/lib/perror 

./lib/prtO.o 

/lib/mprtO.o 

/lib/libmark.a 

/lib/libffp.a 

/lib/libp.a 

/lib/libc.a 

/usr/include / pc/init.h 
/usr/src/cmd/pc/opass[l2] 


preprocessor output file 
error and listing file 
object file 
input file 

assembler listing file 
loaded (linked) output 
temporary files for pc 
preprocessor 
compiler passes for pc 
compiler pass3 
prints errors and listing 
runtime startoflf 
startoff for profiling 

pascal runtime-support (new, mark, release) 
library with floating point routines 
pascal runtime-support 
standard library, see intro (3) 
initialisation of Pascal compilation 
backup compiler passes for pc 
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SEE ALSO 

K. Jensen and N. Wirth Pascal User Manual and Report Springer Verlag 
1978 

monitor(3C), prof(l), adb(l), ld(l) 

DIAGNOSTICS 

The diagnostics produced by pc itself are intended to be self- 
explanatory. Occasional messages may be produced by the loader(ld). 

BUGS 

Nor.e known. 
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NAME 

pg. pn — simple paginators for text files 

SYNOPSIS 

pg file 
pn file 

(any command) | pg 
DESCRIPTION 

pg and pn ore very simple and small programs for displaying text files on 
a terminal. They can be called with one or more filenames or at the end 
of a pipe (for example U | pg ). One cannot alter the files being displayed 
with pg 

The only difference between pg and pn is that pg erases the terminal 
screen before and after paginating the text whereas pn does not. 

pg displays files on a normal (24-line) terminal 23 lines at a time (wrap¬ 
ping lines longer that the screen width around) and waits after each 
screenfull for the user to type in one of the command characters listed 
below. 

When displaying texts, the last line of the terminal is a prompt for user 
input. The prompt tells the user if there is more of the text file to come 
or if he is at the end. 

pg has commands to.look at different parts of a file. They are: 


Command Action 


f 

<RETURN> 

<SPACE> 


(Forwards) pg shows the next 23 lines of the file (if 
there are that many). 

same as f. 
same as f. 


d 

b 

q 

-c 

e 




same as f. 

(Down) pg scrolls the next 15 lines. 

(Back) pg goes back to line 1 of the file. This does not 
work with pipes. 

(Quit) switch to the next file (if there are more) or exit 
pg if not. 

exit pg 

(Edit) pg calls (with exeelp) the user's environment 
editor (shell parameter EDITOR) on the text file being 
paginated. 

Display help file for vsh display mode and pg. 


pg is often better than cat because it automatically waits after each full 
terminal screen. Some people also prefer pg to more because one can go 
backwards in a file (ie. with 'b'). 
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BUGS 

pg has an internal function that tries to make sure that a file to be 
paginated is indeed ascii text. It sometimes gets confused and lets one 
look at a core dump or directory. The command ’b’ is inoperable on 
pipes because one can’t rewind them... Otherwise pg has no known bugs. 

AUTHOR 

Stephen T. Pope at PCS GmbH. Munich, Germany 

SEE ALSO 

pg and pn are essentially the same as the internal paginator of rsh (l) 
and/or the help (l) utility. 
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NAME 

plot — graphics filters 
SYNOPSIS 

plot [ —Tterminal [ raster ] ] 

DESCRIPTION 

These commands read plotting instructions (see plot{ 5)) from the stan¬ 
dard input, and in general produce plotting instructions suitable for a 
particular terminal on the standard output. 

If no terminal type is specified, the environment parameter STERM (see 
environ{ 7)) is used. Known terminals are: 

4014 Tektronix 4014 storage scope. 

450 DASI Hyterm 450 terminal (Diablo mechanism). 

300 DASI 300 or GSI terminal (Diablo mechanism). 

300S DASI 300S terminal (Diablo mechanism). 

ver Versatec D1200A printer-plotter. This version of plot places a 
scan-converted image in Vusr/tmp/raster’ and sends the result 
directly to the plotter device rather than to the standard output. 
The optional argument causes a previously scan-converted file 
raster to be sent to the plotter. 

lbp Canon LBP10 laser beam printer, 

bip CADMUS bit map display. 

FILES 

/usr/bin/tek 

/usr/bin/t450 

/usr/bin/t300 

/usr/bin/t300s 

/usr/bin/vplot 

/usr/tmp/raster 

/usr/bin/lplot 

/usr/bin/bplot 

SEE ALSO 

plot(3X), plot(5) 

BUGS 

There is no lockout protection for /usr/tmp/raster. 
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NAME 

postnews — submit news articles 
SYNOPSIS 

postnews [ article ] 

DESCRIPTION 

Postnews is a shell script that calls ineu;s(l) to submit news articles to 
USENET. It should be edited to reflect your organizations name. It will 
prompt the user for the title of the article (which should be a phrase 
suggesting the subject, so that persons reading the news can tell if they 

are interested in the article) for the newsgroup, and for the distribution 

An omitted newsgroup (from hitting return) will default to general. 

general is read by everyone on the local machine. Other possible news- 

groups include, but are not limited to, btl.general, which is read by all 
users at all Bell Labs sites on USENET, net.general, which is read by all 
users at all sites on USENET, and net.news, which is read by users 
interested in the network news on all sites. There is often a local set of 
newsgroups, such as ucb.all, that circulate within a local set of machines. 
(In this case, uc6 newsgroups circulate among machines at the University 
of California at Berkeley.) 

The distribution can be any valid newsgroup name list, and defaults to 
the same as the newsgroup. (If they are the same, the distribution will be 
omitted from the headers put into the editor buffer.) A distribution 
header will, if given, be included in the headers of the article, affecting 
where the article is distributed to. 

After entering the title, newsgroup, and distribution, the user will be 
placed in an editor. If SEDITOR is set in the environment, that editor will 
be used. Otherwise, postnews defaults to med(l). 

An initial set of headers containing the subject and newsgroups will be 
placed in the editor, followed by a blank line. The article should be 
appended to the buffer, after the blank line. These headers can be 
changed, or additional headers added, while in the editor, if desired. 

Optionally, the article will be read from the specified filename. 

For more sophisticated uses, such as posting news from a program, see 
ineu>s(l). 

FILES 
SEE ALSO 

checknews(l), inews(l), mail(l), readnews(l). 
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NAME 

pr — print files 
SYNOPSIS 

pr [ options ] [ files ] 

DESCRIPTION 

Pr prints the named files on the standard output. If file is —, or if no files 
are specified, the standard input is assumed. By default, the listing is 
separated into pages, each headed by the page number, a date and time, 

ar.d the name of the file. 

Ev default, columns are of equal width, separated by at least one space, 
hr.es which do not fit are truncated. If the —s option is used, lines are not 
truncated and columns are separated by the separation character. 

If the standard output is associated with a terminal, error messages are 
withheld until pr has completed printing. 

Options may appear singly or be combined in any order. Their meanings 
are: 

+Jfc Begin printing with page k (default is l). 

—jfc Produce Jfc-column output (default is l). The options -e and -i are 
assumed for multi-column output. 

—a Print multi-column output across the page. 

-m Merge and print all files simultaneously, one per column (overrides 
the -Jfc. and -a options). 

—d Double-space the output. 

—n Number the lines. 

—ecJfc Expand input tabs to character positions fc + 1, 2*fc + l, 3*fc + l, etc. 
If Jfc is 0 or is omitted, default tab settings at every eighth position 
are assumed. Tab characters in the input are expanded into the 
appropriate number of spaces. If c (any non-digit character) is 
given, it is treated as the input tab character (default for c is the 
tab character). 

—icJfc In output, replace white space wherever possible by inserting tabs 
to character positions Jb + 1, 2*Jfc + l, 3*fc + l. etc. If fc is 0 or is omit¬ 
ted. default tab settings at every eighth position are assumed. If c 
(any non-digit character) is given, it is treated as the output tab 
character (default for c is the tab character). 

—neJfc Provide Jfc-digit line numbering (default for k is 5). The number 
occupies the first Jb + 1 character positions of each column of nor¬ 
mal output or each line of —m output. If c (any non-digit charac¬ 
ter) is given, it is appended to the line number to separate it from 
whatever follows (default for c is a tab). 

—if jfc Set the width of a line to Jfc character positions (default is 72 for 

equal-width multi-column output, no limit otherwise). 

—oJfc Offset each line by Jfc character positions (default is 0). The 

number of character positions per line is the sum of the width and 
offset. 
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—lfc Set the length of a page to k lines (default is 66). 

—h Use the next argument as the header to be printed instead of the 

file name. 

—p Pause before beginning each page if the output is directed to a 

terminal (pr will ring the bell at the terminal and wait for a car¬ 
riage return). 

—f Use form-feed character for new pages (default is to use a 

sequence of line-feeds). Pause before beginning the first page if 

the standard output is associated with a terminal. 

—r Print no diagnostic reports on failure to open files. 

—t Print neither the five-line identifying header nor the five-line 

trailer normally supplied for each page. Quit printing after the 
last line of each file without spacing to the end of the page. 

—sc Separate columns by the single character c instead of by the 
appropriate number of spaces (default for c is a tab). 


EXAMPLES 


Print filel and file2 as a double-spaced, three-column listing headed by 
"file list": 

pr —3dh "file list" filel file2 

Write filel on file2, expanding tabs to columns 10, 19, 28, 37, 
pr —e9 —t <filel >file2 


FILES 


/dev/tty* to suspend messages 


SEE ALSO 


cat(l). 
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NAME 

prep — prepare text for statistical processing 

SYNOPSIS 

prep [ —dio ] file ... 

DESCRIPTION 

Prep reads each file in sequence and writes it on the standard output, 
one 'word' to a line. A word is a string of alphabetic characters and 
imbedded apostrophes, delimited by space or punctuation. Hyphenated 
words are broken apart; hyphens at the end of lines are removed and the 
hyphenated parts are joined. Strings of digits are discarded. 

The following option letters may appear in any order: 

—d Print the word number (in the input stream) with each word. 

—i Take the next file as an 'ignore' file. These words will not appear 

in the output. (They will be counted, for purposes of the —d 
count.) 

—o Take the next file as an 'only' file. Only these words will appear in 

the output. (All other words will also be counted for the —d 
count.) 

—p Include punctuation marks (single nonalphanumeric characters) 

as separate output lines. The punctuation marks are not counted 
for the —d count. 

Ignore and only files contain words, one per line. 

SEE ALSO 

deroff(l) 
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NAME 

prmail - print out mail in the post office 

SYNOPSIS 

prmail [ user ... ] 

DESCRIPTION 

Prmail prints the mail which waits for you, or the specified user, in the 
post office. The mail is not disturbed. 

FILES 

/usr/mail/* post office 

SEE ALSO 

from(l) 
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NAME 

prof — display profile data 
SYNOPSIS 

prof [ —▼ ] [ —a ] [ —1 ] [ —low [ — high. ] ] [ file ] 

DESCRIPTION 

Prof interprets the file mon.out produced by the monitor subroutine. 
Under default modes, the symbol table in the named object file (a.out 
default) is read and correlated with the mon.out profile file. For each 
external symbol, the percentage of time spent executing between that 

symbol and the next is printed (in decreasing order), together with the 
number of times that routine was called and the number of milliseconds 
per call. 

If the —a option is used, all symbols are reported rather than just exter¬ 
nal symbols. If the —1 option is used, the output is listed by symbol value 
rather than decreasing percentage. 

If the —▼ option is used, all printing is suppressed and a graphic version 
of the profile is produced on the standard output for display by the 
plot(IG) filters. The numbers low and high, by default 0 and 100, cause a 
selected percentage of the profile to be plotted with accordingly higher 
resolution. 

In order for the number of calls to a routine to be tallied, the —p option 
of cc must have been given when the file containing the routine was com¬ 
piled. This option also arranges for the mon.ouf file to be produced 
automatically. 

FILES 

mon.out for profile 
a.out for namelist 

SEE ALSO 

monitor(3C). profil(2), cc(l), plot(lG) 

BUGS 

Beware of quantization errors. 
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NAME 

prs — print an SCCS file 


SYNOPSIS 

prs [—d[dataspec]] [—r[SlD]] [—e] [—I] [—a] files 


DESCRIPTION 

Prs prints, on the standard outpu., parts or all of an SCCS file (see 
sccsfile{ 5)) in a user supplied for-fiat. If a directory is named, prs 
behaves as though each file in the directory were specified as a named 
file, except that non-SCCS files (las*, component of the path name does 
not begin with s.), and unreadable files are silently ignored. If a name of 
— is given, the standard input is rc id; each line of the standard input is 
taken to be the name of an SCCS file or directory to be processed; non- 
SCCS files and unreadable files are silently ignored. 


Arguments to prs, which may appear in any order, consist of keyletter 
arguments, and file names. 

All the described keyletter arguments apply independently to each 
named file: 


—d[dafaspec] Used to specify the output data specification. The 
dataspec is a string consisting of SCCS file data key¬ 
words (see DATA KEYWORDS) interspersed with optional 
user supplied text. 

—r[S/Z>] Used to specify the SCCS /Identification (SID) string of 

a delta for which information is desired. If no SID is 
specified, the SID of the most recently created delta is 
assumed. 

—e Requests information for all deltas created earlier 

than and including the delta designated via the —r 
keyletter. 


—1 Requests information for all deltas created later than 

and including the delta designated via the —r 
keyletter. 


—a Requests printing of information for both removed, 

i.e., delta type = R, (see rmdei(l)) and existing, i.e., 
delta type = D, deltas. If the —a keyletter is not 
specified, information for existing deltas only is pro¬ 
vided. 


DATA KEYWORDS 

Data keywords specify which parts of an SCCS file are to be retrieved and 
output. All parts of an SCCS file (see sccsfile{5)) have an associated data 
keyword. There is no limit on the number of times a data keyword may 
appear in a dataspec . 


The information printed by prs consists of: (l) the user supplied text; 
and (2) appropriate values (extracted from the SCCS file) substituted for 
the recognized data keywords in the order of appearance in the 
dataspec. The format of a data keyword value is either Simple (S). in 
which keyword substitution is direct, or Multi-line (M), in which keyword 
substitution is followed by a carriage return. 
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User supplied text is any text other than recognized data keywords. A 
tab is specified by \t and carriage return/new-line is specified by \n. 
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TABLE 1. SCCS Files Data Keywords 



Keyword 

Data Item 

File Section 

Value 

Format 

:Dt: 

Delta information 

Delia Table 

See below* 

S 

:DL: 

Delta line statistics 

i* 

:Li:/:Ld:/:Lu: 

S 

:Li: 

Lines inserted by Delta 

It 

nnnnn 

S 

:Ld: 

Lines deleted by Delta 

M 

nnnnn 

S 

:Lu: 

Lines unchanged by Delta 

M 

nnnnn 

S 

:DT: 

Delta type 

M 

D or R 

S 

:I: 

sees ID string (SID) 

• f 

:R:.:L:.:B:.:S: 

S 

:R: 

Release number 

M 

nnnn 

s 

'.L'. 

Level number 

" 

nnnn 

s 

* 

Branch number 


nnnn 

s 

• v • 

Sequence number 


nnnn 

5 

.•p>. 

Date Delta created 

" 

:Dy:/:Dm:/:Dd: 

s 

:Dy: 

Year Delta created 

It 

nn 

s 

:Dm: 

Month Delta created 

II 

nn 

s 

:Dd: 

Day Delta created 

• r 

nn 

s 

:T: 

Time Delta created 

M 

:Th:::Tm:::Ts: 

s 

:Th: 

Hour Delta created 

• f 

nn 

s 

:Tm: 

Minutes Delta created 

et 

nn 

s 

:Ts: 

Seconds Delta created 

it 

nn 

s 

:P: 

Programmer who created Delta 

it 

logname 

s 

:DS: 

Delta sequence number 

it 

nnnn 

s 

:DP: 

Predecessor Delta seq-no. 

" 

nnnn 

s 

:D1: 

Seq-no. of deltas inch, excl., ignored 


:Dn:/:Dx:/:Dg: 

s 

:Dn: 

Deltas included (seq #) 

• « 

:DS: :DS:... 

s 

:Dx: 

Deltas excluded (seq #) 

it 

:DS: :DS:... 

s 

:Dg: 

Deltas ignored (seq #) 

it 

:DS: :DS:... 

s 

:MR: 

MR numbers for delta 

it 

text 

M 

:C: 

Comments for delta 

it 

text 

M 

:UN: 

User names 

User Names 

text 

M 

:FL: 

Flag list 

Flags 

text 

M 

:Y: 

Module type flag 

ii 

text 

S 

:MF: 

MR validation flag 

ii 

yes or no 

S 

:MP: 

MR validation pgm name 

•i 

text 

S 

:KF: 

Keyword error/warning flag 

it 

yes or no 

S 

:BF: 

Branch flag 

it 

yes or no 

S 

J: 

Joint edit flag 

it 

yes or no 

S 

:LK: 

Locked releases 

it 

:R:_ 

s 

:Q: 

User defined keyword 

it 

text 

s 

:M: 

Module name 

•t 

text 

s 

:FB: 

Floor boundary 

it 

:R: 

s 

:CB: 

Ceiling boundary 

it 

:R: 

s 

:Ds: 

Default SID 

it 

:1: 

s 

:ND: 

Null delta flag 


yes or no 

s 

:FD: 

File descriptive text 

Comments 

text 

M 

:BD: 

Body 

Body 

text 

M 

:GB: 

Gotten body 

it 

text 

M 

:W: 

A form of what{\) string 

N/A 

:Z::M:\ t:I: 

S 

■A: 

A form of u>/iai(l) string 

N/A 

:Z::Y: :M: :I::Z: 

S 

:Z: 

io/ia*(l) string delimiter 

N/A 

©(#) 

S 

:F: 

SCCS file name 

N/A 

text 

S 

:PN: 

SCCS file path name 

N/A 

text 

s 


* :Dt: = :DT: :I: :D: :T: J 3 : :DS: :DP: 
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EXAMPLES 

prs — cT’Users and/or user IDs for :F: are:\n:UN:" s.file 
may produce on the standard output: 

Users and/or user IDs for s.file are: 

xyz 

131 

abc 

prs —d”Newest delta for pgm :M:: :I: Created :D: By :P:" —r s.file 

rr.ay produce on the standard output: 

Newest delta for pgm main.c: 3.7 Created 77/12/1 By cas 
As a special case 

prs s.file 

may produce on the standard output: 

D 1.1 77/12/1 00:00:00 cas 1 000000/00000/00000 
MRs: 

bl78-12345 
bl79-5432l 
COMMENTS: 

this is the comment line for s.file initial delta 

for each delta table entry of the "D” type. The only keyletter argument 
allowed to be used with the special case is the —a keyletter. 

FILES 

/tmp/pr????? 

SEE ALSO 

admin(l), delta(l), get(l), help(l), sccsfile(5). 

Source Code Control System User’s Guide by L. E. Bonanni and C. A. 
Salemi. 

DIAGNOSTICS 

Use help{\) for explanations. 
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NAME 

ps — process status 
SYNOPSIS 

ps [ alx ] [ namelist ] 

DESCRIPTION 

Ps prints certain indicia about active processes. The a option asks for 
information about all processes with terminals (ordinarily only one’s own 
processes are displayed); x asks even about processes with no terminal; 1 
asks for a long listing. The short listing contains the process ID. tty 
letter, the cumulative execution time of the process and an approxima¬ 
tion to the command line. 

The long listing is columnar and contains 

. F Flags associated with the process. 01: in core; 02: system process; 

04: locked in core (e.g. for physical 1/0); 10: being swapped; 20: 
being traced by another process. 

S The state of the process. 0: nonexistent; S: sleeping; W: waiting; R: 
running; I: intermediate; Z: terminated; T: stopped. 

UID The user ID of the process owner. 

P1D The process ID of the process; as in certain cults it is possible to 
kill a process if you know its true name. 

PP1D The process ID of the parent process. 

CPU Processor utilization for scheduling. 

PR1 The priority of the process; high numbers mean low priority. 

NICE Used in priority computation. 

ADDR The core address of the process if resident, otherwise the disk 
address. 

SZ The size in units of lk of the core image of the process. 

WCHAN 

The event for which the process is waiting or sleeping; if blank, the 
process is running. 

TTY The controlling tty for the process. 

TIME The cumulative execution time for the process. 

The command and its arguments. 

A process that has exited and has a parent, but has not yet been waited 
for by the parent is marked <defunct>. Ps makes an educated guess as 
to the file name and arguments given when the process was created by 
examining core memory or the swap area. The method is inherently 
somewhat unreliable and in any event a process is entitled to destroy 
this information, so the names cannot be counted on too much. 

If a second argument is given, it is taken to be the file containing the 
system's namelist, otherwise, /unix is assumed. 

FILES 

/unix system namelist 
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/dev/mem core memory 
/dev/kmem alternate core file 

/dev searched to find swap device and tty names 

SEE ALSO 

kill(l) 

Things can change while ps is running; the picture it gives is only a close 

approximation to reality. 

Some data printed for defunct processes is irrelevant 
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NAME 

pti — phototypesetter interpreter 

SYNOPSIS 

pti [ file ... ] 

DESCRIPTION 

Pti shows the commands in a stream from the standard output of troff{\) 
using troff's —t option, interpreting them as they would act on the 
typesetter. Horizontal motions shows as counts in internal units and are 
marked with '<’ and ■>’ indicating left and right motion. Vertical space is 
called lead and is also indicated. 

SEE ALSO 

trofT(l) 

BUGS 

Too cryptic for normal users, who should use "troff —a ...”. 
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NAME 

ptx — permuted index 
SYNOPSIS 

ptx [ option ] ... [ input [ output ] ] 

DESCRIPTION 

Ptx generates a permuted index to file input on file output (standard 
input and output default). It has three phases: the first does the permu¬ 
tation, generating one line for each keyword in an input line. The key¬ 
word is rotated to the front. The permuted file is then sorted. Finally, 
the sorted lines are rotated so the keyword comes at the middle of the 
page. Ptx produces output in the form: 

,xx "tail" "before keyword" "keyword and after" "head 

where .xx may be an nroff or tro ff{\) macro for user-defined formatting. 

The before keyword and keyword and after fields incorporate as much of 
the line as will fit around the keyword when it is printed at the middle of 
the page. Tail and head, at least one of which is an empty string are 
wrapped-around pieces small enough to fit in the unused space at the 
opposite end of the line. When original text must be discarded. V marks 
the spot. 

The following options can be applied: 

— f Fold upper and lower case letters for sorting. 

-t Prepare the output for the phototypesetter; the default line 
length is 100 characters. 

-w n Use the next argument, n. as the width of the output line. The 
default line length is 72 characters. 

-g n Use the next argument, n. as the number of characters to allow 
for each gap among the four parts of the line as finally printed. 
The default gap is 3 characters. 

—o only 

Use as keywords only the words given in the only file. 

—i ignore 

Do not use as keywords any words given in the ignore file. If the -i 
and -o options are missing, use /usr/lib/eign as the ignore file. 

—b break 

Use the characters in the break file to separate words. In any 
case, tab. newline, and space characters are always used as break 
characters. 

—r Take any leading nonblank characters of each input line to be a 

reference identifier (as to a page or chapter) separate from the 
text of the line. Attach that identifier as a 5th field on each out¬ 
put line. 

The index for this manual was generated using ptx. 

FILES 

/bin/sort 

/usr/lib/eign 
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EXAMPLE # A t . ...... 

The following is a reasonably-minimal set of nroff statements which will 
format ptx output reasonably; the style is similar to the index for this 
manual. The spacings may need adjustment for different output devices. 


.if ! '\ \ 81" \ \ 81 \ fl\ a\ fR\ \ S2\ t\ \ S3\ f I\ a\ fR\ t\ \ 85 
.if \ 84” \ t\ \ S2\ t\ \ 83\ fl\ a\ fR\ \ 84\ t\ \ 85 
.if " M \\8l\\84" \t\\82\t\\83\fI\a\fR\t\\85 


.nf 

.ta 3.7iR 3.95iL7.65iR 7.8iR 

Line length counts do not account for overstriking or proportional spac 
ing- 
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NAME 

pwd — working directory name 

SYNOPSIS 

pwd 

DESCRIPTION 

Pwd prints the pathname of the working (current) directory. 

SEE ALSO 

cd( 1) 
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NAME 

ranlib - convert archives to random libraries 

SYNOPSIS 

ranlib archive ... 

DESCRIPTION 

Ranlib converts each archive to a form which can be loaded more rapidly 

by the loader, by adding a table of contents named_.SYMDEF to the 

beginning of the archive. It uses or(l) to reconstruct the archive, so 
that sufficient temporary file space must be available in the file system 
containing the current directory. 

SEE ALSO 

ld(l). ar(l) 

BUGS 

Because generation of a library by ar and randomization by ranlib are 
separate, phase errors are possible. The loader Id warns when the 
modification date of a library is more recent than the creation of its dic¬ 
tionary; but this means you get the warning even if you only copy the 
library. 


Page 1 


February 17, 1984 










RATFOR(l) 


llUNIX 


RATFOR(l) 


NAME 

ratfor — rational Fortran dialect 
SYNOPSIS 

ratfor [ options ] [ files ] 

DESCRIPTION .. ... , r 

Ratfor converts a rational dialect of Fortran into ordinary irrational For 
tran. Ratfor provides control flow constructs essentially identical to 
those in C: 

statement grouping: 

f statement; statement; statement j 

decision-making: 

if (condition) statement [ else statement J 
switch (integer value) { 

case integer: statement 

[ default: ] statement 

\ 

loops: 

while (condition) statement 

for (expression; condition; expression) statement 

do limits statement 

repeat statement [ until (condition) ] 

break 

next 

and some syntactic sugar to make programs easier to read and write: 
free form input: 

multiple statements/line; automatic continuation 

comments: 

§ this is a comment. 

translation of relationals: 

>. >=, etc., become .GT., .GE.. etc. 

return expression to caller from function: 
return (expression) 

define: 

define name replacement 

include: 

include file 

The option -h causes quoted strings to be turned into 27H constructs. 
The —C option copies comments to the output and attempts to format it 
neatly. Normally, continuation lines are marked with a & in colunm 1; 
the option -6x makes the continuation character x and places it in 
column 6. 

Ratfor is best used with /77(l). 

SEE ALSO 

EL^Kernighan and P. J. Plauger. Software Tools. Addison-Wesley. 1976. 
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NAME 

readnews — read news articles 
SYNOPSIS 

readnews [ -a date ] [ — n newsgroups ] [ — t titles ] [ —lpnchfull ] [ 
—c [ mailer ] ] 

readnews —s 
DESCRIPTION 

readnews without argument prints unread articles. There are several 
interfaces available: 

Flag Interface *- 

default A msys(l) like interface. 

—II An interface to Mail{ 1). 

—c A /bin /moiZ(l)-like interface. 

—c "mailer" 

All selected articles written to a temporary file. Then the mailer 
is invoked. The name of the temporary file is referenced with a 
Thus, "mail — f 55” will invoke mail on a temporary file con¬ 
sisting of all selected messages. 

—p All selected articles are sent to the standard output. No ques¬ 

tions asked. 

—1 Only the titles output. The .netusrc file will not be updated. 

The —r flag causes the articles to be printed in reverse order. The —f flag 
prevents any followup articles from being printed. The —h flag causes 
articles to be printed in a less verbose format, and is intended for termi¬ 
nals running at 300 baud, the —u flag causes the .newsrc file to be 
updated every 5 minutes, in case of an unreliable system. (Note that if 
the newsrc file is updated, the x command will not restore it to its origi¬ 
nal contents.) 

The following flags determine the selection of articles. 

—n newsgroups 

Select all articles that belong to newsgroups. 

—t titles Select all articles whose titles contain one of the strings 
specified by titles. 

—a [ date ] 

Select all articles that were posted past the given date (in get- 
date{ 3) format). 

—x Ignore .newsrc file. That is, select articles that have already 

been read as well as new ones. 

readnews maintains a .netusrc file in the user's home directory that 
specifies all news articles already read. It is updated at the end of each 
reading session in which the —x or —1 options weren't specified. If the 
environment variable NEWSRC is present, it should be the path name of a 
file to be used in place of .newsrc. 

If the user wishes, an options line may be placed in the .newsrc file. This 
line starts with the word options (left justified) followed by the list of 
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standard options just as they would be typed on the command line. Such 
a list may include: the —n flag along with a newsgroup list; a favorite 
interface; and/or the — r or —t flag. Continuation lines are specified by 
following lines beginning with a space or tab character. Similarly, 
options can be specified in the NEWSOPTS environment parameter. 
Where conflicts exist, option on the command line take precedence, fol¬ 
lowed by the .newsrt options line, and lastly the NEWSOPTS parameter. 

readnews —a will print the newsgroup subscription list. 

When the user uses the reply command of the msgrs(l) or /bin/mail(l) 
interfaces, the environment parameter HAILER will be used to determine 
which mailer to use. The default is usually /bin/mail. 

If the user so desires, he may specify a specific paging progam for arti¬ 
cles. The environment parameter PAGER should be set to the paging pro¬ 
gram. The name of the article is referenced with a ’%', as in the —c 
option. If no is present, the article will be piped to the program. Pag¬ 
ing may be disabled by setting PAGER to a null value. 

COMMANDS 

This section lists the commands you can type to the msgs and /bin/mail 
interface prompts. The msgs interface will suggest some common com¬ 
mands in brackets. Just hitting return is the same as typing the first 
command. For example, "[ynq]" means that the commands "y” (yes), 
•‘n” (no), and ”q" (quit) are common responses, and that "y” is the 
default. Command Meaning 

y Yes. Prints current article and goes on to next. 

n No. Goes on to next article without printing current one. In the 
/bin/mail interface, this means "go on to the next article", which 
will have the same effect as "y” or just hitting return. 

q Quit. The .newsrc file will be updated if -1 or -x were not on the 
command line. 

c Cancel the article. Only the author or the super user can do this. 

r Reply. Reply to article’s author via mail. You are placed in your 

EDITOR with a header specifying To, Subject, and References lines 
taken from the message. You may change or add headers, as 
appropriate. You add the text of the reply after the blank line, 
and then exit the editor. The resulting message is mailed to the 
author of the article. 

rd Reply directly. You are placed in SMAILER ("mail" by default) in 
reply to the author. Type the text of the reply and then control-Z. 

f [title] 

Submit a follow up article. Normally you should leave off the title, 
since the system will generate one for you. You will be placed in 
your EDITOR to compose the text of the followup. 

fd Followup directly, without edited headers. This is like /, but the 
headers of the article are not included in the editor buffer. 

N [newsgroup] 

Go to the next newsgroup or named newsgroup. 
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s [file] 

Save. The article is appended to the named file. The default is 
‘'Articles”. If the first character of the file name is *|\ the rest of 
the file name is taken as the name of a program, which is executed 
with the text of the article as standard input. If the first charac¬ 
ter of the file name is */', it is taken as a full path name of a file. If 
SNEWSBOX (in the environment) is set to a full path name, and the 
file contains no V. the file is saved in SNEWSBOX. Otherwise, it is 
saved relative to SHOME. 

§ Report the name and size of the newsgroup, 
e Erase. Forget that this article was read, 
h Print a more verbose header. 

H Print a very verbose header, containing all known information 
about the article. 

U Unsubscribe from this newsgroup. Also goes on to the next news- 
group. 

d Read a digest. Breaks up a digest into separate articles and per¬ 
mits you to read and reply to each piece. 

D Decrypt. Invokes a Caesar decoding program on the body of the 
message. This is used to decrypt rotated jokes posted to net.jokes. 
Such jokes are usually obscene or otherwise offensive to some 
groups of people, and so are rotated to avoid accidental decryp¬ 
tion by people who would be offended. The title of the joke should 
indicate the nature of the problem, enabling people to decide 
whether to decrypt it or not. 

Normally the Caesar program does a character frequency count on each 
line of the article separately, so that lines which are not rotated will be 
shown in plain text. This works well unless the line is short, in which case 
it sometimes gets the wrong rotation. An explicit number rotation (usu¬ 
ally 13) may be given to force a particular shift. 

v Print the current version of the news software. 

! Shell escape. 

number 

Go to number. 

+[n] Skip n articles. The articles skipped are recorded as "unread” 
and will be offered to you again the next time you read news. 

Go back to last article. This is a toggle, typing it twice returns you 
to the original article. 

x Exit. Like quit except that .newsrc is not updated. 

X system 

Transmit article to the named system. 

The commands c, f, fd, r. rd. e, h, H. and s can be followed by -'s to refer 
to the previous article. Thus, when replying to an article using the msgs 
interface, you should normally type "r-“ (or "re-") since by the time you 
enter a command, you are being offerred the next article. 
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EXAMPLES 

readnews 

Read all unread articles using the msgs( 1) interface. The 
.netusrc file is updated at the end of the session. 

readnews —c “ed X" —1 

Invoke the ed(l) text editor on a file containing the titles of all 
unread articles. The .newsrc file is not updated at the end of 
the session. 

readnews —n all !fa.all —II —r 

Read all unread articles except articles whose newsgroups begin 
with ''fa." via A/aiZ(l) in reverse order. The .newsrc file is 
updated at the end of the session. 

readnews — p —n all —a last thursday 

Print every unread article since last Thursday. The .newsrc file 
is updated at the end of the session. 

readnews —p > /dev/nuU Sc 

Discard all unread news. This is useful after returning from a 
long trip. 

FILES 

/usr/spool/news /newsgroup /number 

News articles 

/usr/lib/news/active Active newsgroups and numbers of articles 
/usr/lib/news/help Help file for msgs( l) interface 
~/.newsrc Options and list of previously read articles 

SEE ALSO 

checknews(l). inews(l), sendnews(8), recnews(8), uurec(8), msgs(l). 
Mail(l), mail(l), news(5), newsrc(5) 

AUTHORS 

Matt Glickman 
Mark Horton 
Stephen Daniel 
Tom R. Truscott 
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NAME 

recnews — receive unprocessed articles via mail 
SYNOPSIS 

recnews ( newsgroup [ sender ] ) 

DESCRIPTION 

recnews reads a letter from the standard input; determines the article 
title, sender, and newsgroup; and gives the body to inews with the right 
arguments for insertion. 

If newsgroup is omitted, the to line of the letter will be used. If sender is 
omitted, the sender will be determined from the from line of the letter. 
The title is determined from the subject line. 

SEE ALSO 

inews(l). uurec(8). sendnews(8), readnews(l). checknews(l) 


Page 1 


February 17. 1904 








REFER(1) 


lfUNIX 


REFER(1) 


NAME 

refer, lookbib — find and insert literature references in documents 

SYNOPSIS 

refer [ option ] ... 

lookbib [ file ] ... 

DESCRIPTION 

Lookbib accepts keywords from the standard input and searches a biblio¬ 
graphic data base for references that contain those keywords anywhere 
in title, author, journal name, etc. Matching references are printed on 
the standard output. Blank lines are taken as delimiters between 
queries. 

Refer is a preprocessor for nrojf or trojf(l) that finds and formats refer¬ 
ences. The input files (standard input default) are copied to the stan¬ 
dard output, except for lines between .[ and .] command lines, which are 
assumed to contain keywords as for lookbib, and are replaced by infor¬ 
mation from the bibliographic data base. The user may avoid the search, 
override fields from it, or add new fields. The reference data, from what¬ 
ever source, are assigned to a set of troff strings. Macro packages such 
as ms (7) print the finished reference text from these strings. A flag is 
placed in the text at the point of reference; by default the references are 
indicated by numbers. 

The following options are available: 

—ar Reverse the first r author names (Jones, J. A. instead of J. A. Jones). 
If r is omitted all author names are reversed. 

—b Bare mode: do not put any flags in text (neither numbers nor 
labels). 

—cstring 

Capitalize (with CAPS SMALL CAPS) the fields whose key-letters are in 
string. 

—e Instead of leaving the references where encountered, accumulate 
them until a sequence of the form 
•[ 

SL1STS 

•] 

is encountered, and then write out all references collected so far. 
Collapse references to the same source. 

—kx Instead of numbering references, use labels as specified in a refer¬ 
ence data line beginning Zx; by default x is L. 

—lrn.n 

Instead of numbering references, use labels made from the senior 
author’s last name and the year of publication. Only the first m 
letters of the last name and the last n digits of the date are used. 
If either m or ,n is omitted the entire name or date respectively is 
used. 

—p Take the next argument as a file of references to be searched. The 
default file is searched last. 
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FILES 


—n Do not search the default file. 

—skeys 

Sort references by fields whose key-letters are in the keys string; 
permute reference numbers in text accordingly. Implies —e. The 
key-letters in keys may be followed by a number to indicate how 
many such fields are used, with + taken as a very large number. 
The default is AD which sorts on the senior author and then date; to 
sort, for example, on all authors and then title use -aA+T. 

To use your own references, put them in the format described in pubin- 
dex(l) They can be searched more rapidly by running pubindex(l) on 
them before using refer; failure to index results in a linear search. 

When refer is used with eqn , neqn or tbl, refer should be first, to minimize 
the volume of data passed through pipes. 

/usr/diet/papers directory of default publication lists and indexes 
/usr/lib/refer directory of programs 


SEE ALSO 
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NAME 


reform — reformat text file 


SYNOPSIS 


reform [tabspecl [tabspec2]] [+bn] [+en] [+f] [+in] [+mn] [+pn] [+») 
[+tn] 


DESCRIPTION 


Reform reads each line of the standard input file, reformats it, and then 
writes it to the standard output. Various combinations of reformatting 
operations can be selected, of which the most common involve rear¬ 
rangement of tab characters. It is often used to trim trailing blanks, 
truncate lines to a specified length, or prepend blanks to lines. 

Reform first scans its arguments, which may be given in any order. It 
then processes its input file, performing the following actions upon each 
line, in the order given: 

- A line is read from the standard input. 

- If +s is given, all characters up to the first tab are stripped off and 
saved for later addition to the end of the line. Presumably, these 
characters comprise an "SCCS SID" produced by pef(l). 

- The line is expanded into a tabless form, by replacing tabs with blanks 
according to the input tab specification tabspecl. 

- If +pn is given, n blanks are prepended to the line. 

- If +tn is given, the line is truncated to a length of n characters. 

- All trailing blanks are now removed. 

- If +en is included, the line is extended out with blanks to the length of 
n characters. 

- If +s is given, the previously-saved “SCCS SID" is added to the end of 
the line. 

- If +bn is given, the n characters at the beginning of the line are con¬ 
verted to blanks, if and only if all of them are either digits or blanks. 

- If +nm is included, the line is moved left, i.e., ti characters are 
removed from the beginning of the line. 

- The line is now contracted by replacing some blanks with tab charac¬ 
ters according to the list of tabs indicated by the output tab 
specification tabspec2, and is written to the standard output file. 
Option +i controls the method of contraction (see below). 

The various arguments accepted by reform are as follows: 


tabspecl 


describes the tab stops assumed for the input file. This tab 
specification may take on any of the forms described in tabs{ 1). 
In addition, the operand — indicates that the tab specification 
is to be found in the first line read from the standard input. If 
no legal tab specification is found there. -8 is assumed. If 
tabspecl is omitted entirely, — is assumed. 


tabspec2 


describes the tabs assumed for the output file. It is 
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interpreted in the same way as tabspecj, except that omission 
of tabspec2 causes the value of tabspecl to be used for 
tabspec2. 

The remaining arguments are all optional and may be used in any com¬ 
bination. although only a few combinations make much sense. Specify¬ 
ing an argument causes an action to be performed, as opposed to the 
usual default of not performing the action. Some options include 
numeric values, which also have default values. Option actions are 
applied to each line in the order described above. Any line length men¬ 
tioned applies to the length of a line just before the execution of the 
option described, and the terminating new-line is never counted in the 
line length. 

+bn causes the first n characters of a line to be converted to 
blanks, if and only if those characters include only blanks and 
digits. If n is omitted, the default value is 6. which is useful in 
deleting sequence numbers from COBOL programs. 

+en causes each line shorter than n characters to be extended out 
with blanks to that length. Omitting n implies a default value 
of 72. This option is useful for those rare cases in which 
sequence numbers need to be added to an existing unnum 
bered file. The use of S in editor regular expressions is more 
convenient if all lines have equal length, so that the user can 
issue editor commands such as: 
s/800001000/ 

+f causes a format line to be written to the standard output, 

preceding any other lines written. See fspec(5) for details 
regarding format specifications. The format line is taken from 
tabspec2, i.e.. the line normally appears as follows: 

<:t— tabspec2 d:> 

If tabspec2 is of the form — file-name (i.e.. an indirect reference to a 

tab specification in the first line of the named file), then that tab 

specification line is written to the standard output. 

+in controls the technique used to compress interior blanks into 
, tabs. Unless this option is specified, any sequence of 1 or more 
blanks may be converted to a single tab character if that 
sequence occurs just before a tab stop. This causes no prob 
lems for blanks that occur before the first nonblank character 
in a line, and it is always possible to convert the result back to 
an equivalent tabless form. However, occasionally an interior 
blank (one occurring after the first nonblank) is converted to 
a tab when this is not intended. For instance, this might occur 
in any program written in a language utilizing blanks as delim¬ 
iters. Any single blank might be converted to a tab if it 
occurred just before a tab stop. Insertion or deletion of char¬ 
acters preceding such a tab may cause it to be interpreted in 
an unexpected way at a later time. If the +i option is used, no 
string of blanks may be converted to a tab unless there are n 
or more contiguous blanks. The default value is 2. Note that 
- leading blanks are always converted to tabs when possible. It 
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is recommended that conversion of programs from non -UNIX 
to UNIX systems use this option. 

+mn causes each line to be moved lift n characters, with a default 
value of 6. This can be useful for crunching COBOL programs. 

+pn causes n blanks to be prepended (default of 6 if n is omitted). 

This option is effectively the inverse of +mn, and is often useful 
for adjusting the position of nroff{\) output for terminals lack¬ 
ing both forms tractor positioning and a settable left margin. 

+s is used with the —m option of pef(l). The —m option causes get 
to prepend to each generated line the appropriate SCCS SID. 
followed by a tab. The +s option causes reform to remove the 
SID from the front of the line, save it. then add it later to the 
end of the line. Because +e72 is implied by this option, the 
effect is to produce 80-character card images with SCCS SID in 
columns 73—80. Up to 8 characters of the SID are shown; if it is 
longer, the eighth character is replaced by • and any charac¬ 
ters to the right of it are discarded. 

+tn causes any line longer than n characters to be truncated to 
that length. If n is omitted, the length defaults to 72. 
Sequence numbers can thus be removed and any blanks 
immediately preceding them deleted. 

The following illustrate typical uses of reform. The terms PWB and 
OBJECT below refer to UNIX and non- UNIX computer systems, respec¬ 
tively. Each arrow indicates the direction of conversion. The character 
? indicates an arbitrary tab specification; see fa6s(l) for descriptions of 
legal specifications. 

OBJECT-> PWB (i.e., manipulation of RJE output): 

Note that files transferred by RJE from OBJECT to PWB materialize with 
format —8. 

reform -8 —c +t +b +i Coldfile >newfile (into COBOL) 

reform—8 —c3 +t +m +i <oldfile >newfile (into COBOL crunched) 

NOTE: — c3 is the preferred format COBOL: it uses the least disk space of the 
COBOL formats. 

PWB-> OBJECT (i.e., preparation of files for RJE submission): 

reform ? -8 <oldfile >newfile (from arbitrary format into —8) 
get -p — m sccsfile | reform +s | send ... 

PWB ONLY (i.e.. no involvement with other systems): 

pr file | reform ? —0 Coldfile (print on terminal without hardware tabs) 
reform ? —0 Coldfile >newfile (convert file to tabless format) 

DIAGNOSTICS 

All diagnostics are fatal, and the offending line is displayed following the 
message. 

"line too long" a line exceeds 512 characters (in tabless form). 

"not SCCS — m” a line does not have at least.one tab when +s flag is used. 
Any of the diagnostics of fabs(l) can also appear. 
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EXIT CODES 

0 - normal 
1 — any error 

SEE ALSO 

get(l). nrofl(l), send(lC). tabs(l). fspec(5). 

BUGS 

Reform is aware of the meanings of backspaces and escape sequences, so 
that it can be used as a postprocessor for nroff. However, be warned 
that the +e, +m, and +t options only count characters, not positions. 
Anyone using these options on output containing backspaces or halfline 
motions will probably obtain unexpected results. 


\ 
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NAME 

regcmp — regular expression compile 

SYNOPSIS 

regcmp [ — ] files 

DESCRIPTION 

Regcmp, in most cases, precludes the need for calling regcmp (see 
repex(3X)) from C programs. This Saves on both execution time and pro¬ 
gram size. The command regcmp compiles the regular expressions in file 
and places the output in file A. If the — option is used, the output will be 
placed in file. c. The format of entries in file is a name (C variable) fol¬ 
lowed by one or more blanks followed by a regular expression enclosed in 
double quotes. The output of regcmp is C source code. Compiled regular 
expressions are represented as extern char vectors. File A files may thus 
be included into C programs, or file. c files may be compiled and later 
loaded. In the C program which uses the regcmp output, regex{abc,line) 
will apply the regular expression named abc to line. Diagnostics are 
self-explanatory. 

EXAMPLES 

name "([ A—Za—z][ A—Za—iO—9_] •)$0’’ 

telno ”\ ({0,11([2—9][0l][l—9])S0\ ){0,lj •" 

"([2—9][0—9]{2{)Sl[ —]{0.1{’’ 

"([0—9]{4{)82" 

In the C program that uses the regcmp output, 
regex(telno. line, area, exch, rest) 
will apply the regular expression named telno to line. 

SEE ALSO 

regex(3X). 
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NAME 

rev — reverse lines of a file 

SYNOPSIS 

rev [ file ] ... 

DESCRIPTION 

Rev copies the named files to the standard output, reversing the order of 
characters in every line. If no file is specified, the standard input is 
copied. 


Page 1 


February 17,1984 







RJESTAT(IC) 


MUNDC 


RJESTAT(IC) 


NAME 

rjestat - RJE status report and interactive status console 
SYNOPSIS 

rjestat [ host ]... [ -ahost ] [ -chost cmd ]... 

DESCRIPTION 

Rjestat provides a method of determining the status of an RJE link and of 
simulating an IBM remote console (with UNIX features added). When 
invoked with no arguments, rjestat reports the current status of all the 
RJE links connected to to the UNDC system. The options are: 

host Print the status of the line to host. Host is the pseudonym 

for a particular IBM system. It can be any name that 
corresponds to one in the first column of the RJE 
configuration file. 

-s host After all the arguments have been processed, start an 

interactive status console to host. 

-chost cmd Interpret cmd as if it were entered in status console mode to 
host . See below for the proper format of cmd. 

In status console mode, rjestat prompts with the host pseudonym fol¬ 
lowed by : whenever it is ready to accept a command. Commands are ter¬ 
minated with a new-line. A line that begins with ! is sent to the UNDC shell 
for execution. A line that begins with the letter q terminates rjestat. All 
other input lines are assumed to have the form: 

ibmcmd [ redirect ] 

Ibmcmd is any IBM JES or HASP command. Only the super-user or rje 
login can send commands other than display or inquiry commands. 
Redirect is a pipeline or a redirection to a file (e.g., *'> file" or " | grep 
..."). The IBM response is written to the pipeline or file. If redirect is not 
present, the response is written to the standard output of rjestat. 

An interrupt signal (DEL or BREAK) will cancel the command in progress 
and cause rjestat to return to the command input mode. 

EXAMPLE 

The following command reports the status of all the card readers 
attached to host A. remote 5. JES2 is assumed. , 

rjestat -cA ’8du,rmt5 | grep RD’ 

DIAGNOSTICS 

The message "RJE error: ...” indicates that rjestat found an inconsistency 
in the RJE system. This may be transient but should be reported to the 
site administrator. 


FILES 

/usr/rje/lines RJE configuration file 

reS p host response file that exists in the RJE subsystem direc¬ 

tory (e.g.. /usr/rjel). 


SEE ALSO 

send(lC), rje(8). 

0S/VS2 HASPII Version 4 Operator's Guide , IBM SRL #GC27-6993. 
Operator's Library: 0S/VS2 Reference (JES2), IBM SRL #GC38-0210. 
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NAME 

to, rmdir - remove files or directories 

SYNOPSIS 

mi [ —fri ] file ... 

rmdir dir ... 

DESCRIPTION 

Rm removes the entries for one or more files from a directory. If an 
entry was the last link to the file, the file is destroyed. Removal of a file 
requires write permission in its directory, but neither read nor write per¬ 
mission on the file itself. 

If a file has no write permission and the standard input is a terminal, its 
permissions are printed and a line is read from the standard input. If 
that line begins with y the file is deleted, otherwise the .file remains. No 
questions are asked when the -f option is given or if the standard input 
is not a terminal. 

If a designated file is a directory, an error comment is printed unless the 
optional argument —r has been used. In that case, to recursively 
deletes the entire contents of the specified directory, and the directory 
itself. 

If the -i (interactive) option is in effect, rm asks whether to delete each 
file, and, under —r. whether to examine each directory. 

Rmdir removes entries for the named directories, which must be empty. 

SEE ALSO 

unlink(2). 

DIAGNOSTICS l ^ 

Generally self-explanatory. It is forbidden to remove the file .. merely to 
avoid the antisocial consequences of inadvertently doing something like: 

rm —r .• 


Page 1 


February 17,1984 







I 







RMDEL(l) 


liUNIX 


RUDEL(l) 


NAME 

rmdel - remove a delta from an SCCS file 

SYNOPSIS 

rmdel —rSID files 

DESCRIPTION 

Rmdel removes the delta specified by the SID from each named SCCS file. 
The delta to be removed must be the newest (most recent) delta in its 
branch in the delta chain of each named SCCS file. In addition, the 
specified must nof be that of a version being edited for the purpose of 
making a delta (i. e.. if a p-file (see yef(l)) exists for the named SCCS file, 
the specified must nof appear in any entry of the p-file). 

If a directory is named, rmdel behaves as though each file in the direc¬ 
tory were specified as a named file.jexcept that non-SCCS files (last com¬ 
ponent of the path name does not begin with s.) and unreadable files are 
silently ignored. If a name of — is given, the standard input is read; each 
line of the standard input is taken to be the name of an SCCS file to be 
processed; non-SCCS files and unreadable files are silently ignored. 

The exact permissions necessary to remove a delta are documented in 
the Sburce Code Control System User's Guide. Simply stated, they are 
either (l) if you make a delta you can remove it; or (2) if you own the file 
and directory you can remove a delta. 

FILES 

x-file (see deifa(l)) 

2 -file (see delta(l)) 

SEE ALSO 

delta(l), get(l), help(l). prs(l). sccsfile(5). 

Source Code Control System User's Guide by L. E. Bonanni and C. A. 
Salemi. 

DIAGNOSTICS 

Use help{ 1) for explanations. 
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NAME 

rxctrl - floppy disk manipulating program 
SYNOPSIS 

rxctrl — [ fsdiz ] /dev/me? 

DESCRIPTION 

Rxctrl is used to give commands to the floppy drive: 

f Format data fields according to specified floppy density. This does 
not replace rxformat (see /orma*(8)). which must be used to format 
new floppies. 

s Byte swapping on. 

d restore default setting: no byte swap, interleave of sectors on. first 
fill upper, then lower floppy side. 

Unusual commands: 

i Interleave of sectors off. 

z Zigzag on: sequential blocks on different floppy sides. 

FILES 

/dev/rrx* 

SEE ALSO 

rx(4). format(8) 
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NAME 


ranlib - convert archives to random libraries 


SYNOPSIS 

ranlib archive ... 

DESCRIPTION 

Ranlib converts each archive to a form which can be loaded more rapidly 

by the loader, by adding a table of contents named- .SY1IDEF to the 

beginning of the archive. It uses ar(l) to reconstruct the archive, so 
that sufficient temporary file space must be available in the file system 
containing the current directory. 

SEE ALSO 

Id(1). ar(l) 


Because generation of a library by ar and randomization by ranlib are 
separate, phase errors are possible. The loader Id warns when the 
modification date of a library is more recent than the creation of its dic¬ 
tionary; but this means you get the warning even if you only copy the 
library. 
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NAME 

ratfor — rational Fortran dialect 
SYNOPSIS 

ratfor [ options ] [ files J 


DESCRIPTION 

Ratfor converts a rational dialect of Fortran into 
tran. Ratfor provides control flow constructs 
those in C: 


ordinary irrational For- 
essentially identical to 


statement grouping: 

j statement; statement; statement | 


decision-making: 

if (condition) statement [ else statement J 
switch (integer value) { 

case integer: statement 

[ default: ] statement 

J 

loops: 

while (condition) statement 

for (expression; condition; expression) statement 

do limits statement 

repeat statement [ until (condition) J 

break 

next 

and some syntactic sugar to make programs easier to read and write: 
free form input: 

multiple statements/line; automatic continuation 


comments: 

f this is a comment. 

translation of relationals: 

>, >=, etc., become .GT., .GE., etc. 

return expression to caller from function, 
return (expression) 

define: 

define name replacement 

include: 

include file 

The option — h causes quoted strings to be turned into 27H constructs. 
The —C option copies comments to the output and attempts to format it 
neatly. Normally, continuation lines are marked with a & in column 1; 
the option — 6x makes the continuation character x and places it in 

column 6. 

Ratfor is best used with /77(l). 

SEE ALSO 

RW 1 Kernighan and P. J. Plauger. Software Tools, Addison-Wesley. 1976. 
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NAME 

sact - print current SCCS file editing activity 

SYNOPSIS 

sact files 

DESCRIPTION 

Sac* informs the user of any impending deltas to a named SCCS file. This 
situation occurs when pe*(l) with the —e option has been previously exe* 
cuted without a subsequent execution of delta(l). If a directory is 
named on the command line, sac* behaves as though each file in the 
directory were specified as a named file, except that non-SCCS files and 
unreadable files are silently ignored. If a name of — is given, the stan¬ 
dard input is read with each line being taken as the name of an SCCS file 
to be processed. 

The output for each named file consists of five fields separated by spaces. . 

Field 1 specifies the SID of a delta that currently exists in the 
SCCS file to which changes will be made to make the new 
delta. 

Field 2 specifies the SID for the new delta to be created. 

Field 3 contains the logname of the user who will make the delta 

(i.e. executed a get for editing). 

Field 4 contains the date that get -e was executed. 

Field 5 contains the time that get -e was executed. 

SEE ALSO 

delta(l), get(l), unget(l). 

DIAGNOSTICS 

Use help(l) for explanations. 
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NAME 

sag — system activity graph 

SYNOPSIS 

sag [ options ] 

DESCRIPTION 

Sag graphically displays the system activity data stored in a binary data 
file by a previous sar(l) run. Any of the sar data items may be plotted 
singly, or in combination; as cross plots, or versus time. Simple arith¬ 
metic combinations of data may be specified. Sag invokes sar and finds 
the desired data by string-matching the data column header (run sar to 
see what’s available). These options are passed thru to sar: 

—s time Select data later than time in the form hh[:mm]. Default is 
08:00. 

—e time Select data up to time. Default is 18:00. 

—i sec Select data at intervals as close as possible to sec seconds. 

—I file Use file as the data source for sar. Default is the current daily 
data file /usr/adm/sa/sadd. 

Other options: 

—T term 

Produce output suitable for terminal term. See tplot(lG) for 
known terminals. Default for term is STERM. 

—x spec 

x axis specification with spec in the form: 

"name [op name]... [lo hi]" 

—y spec 

y axis specification with spec in the same form as above. 

Name is either a string that will match a column header in the sar 
report, with an optional device name in square brackets, eg.. 
r+w/s[dsk—1], or an integer value. Op is + - • or / surrounded by 
blanks. Up to five names may be specified. Parentheses are not recog¬ 
nized. Contrary to custom. + and - have precedence over • and /. 
Evaluation is left to right. Thus A / A + B • 100 is evaluated 
(A/(A+B))*100. and A + B/ C + Dis (A+B)/(C+D). Lo and hi are 
optional numeric scale limits. If unspecified, they are deduced from the 
data. 

A single spec is permitted for the x axis. If unspecified, time is used. Up 
to 5 spec's separated by ; may be given for —y. Enclose the — x and —y 
arguments in if blanks or \<CR> are included. The -y default is: 

—y "Xusr 0 100; Xusr + Xsys 0 100; Xusr + Xsys + Xwio 0 100” 

EXAMPLES 

To see today’s CPU utilization: 
sag 

To see activity over 15 minutes of all disk drives: 

TS='date 

sar —o tempfile 60 15 
TE= x date 
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sag -f tempfile -s STS -e STE -y ,, r+w/s[dsk]” 

FILES 

/usr/adm/sa/sadd daily data file for day dd. 

SEE ALSO 

sar(l), tplot(lG). 
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NAME 

sar - system activity reporter 
SYNOPSIS 

sar [—ubdycwaqvmA] [—o file] t [ n ] 

sar [—ubdycwaqvmA] [—a time] [ — e time] [— i sec] [— f file] 
DESCRIPTION 

Sar, in the first instance, samples cumulative activity counters in the 
operating system at n intervals of t seconds. If the —o option is specified, 
it saves the samples in file in binary format. The default value of n is 1. 
In the second instance, with no sampling interval specified, sar extracts 
data from a previously recorded file, either the one specified by —f option 
or, by default, the standard system activity daily data file 
/usr/adm/sa/sadd for the current day dd. The starting and ending 
times of the report can be bounded via the —a and —e time arguments of 
the form AA[:mm[:ss]]. The —i option selects records at sec second inter¬ 
vals. Otherwise, all intervals found in the data file are reported. 

In either case, subsets of data to be printed are specified by option: 

-u Report CPU utilization (the default): 

%usr, %sys, 55wio, /Sidle - portion of time running in user mode, run¬ 
ning in system mode, idle with some process waiting for block I/O. 
and otherwise idle. 

—b Report buffer activity: 

bread/s, bwrit/s - transfers per second of data between system 
buffers and disk or other block devices; 
lread/s, lwrit/s - accesses of system buffers; 

%rcache, %wcache - cache hit ratios, e. g., 1 - bread/lread; 
pread/s, pwrit/s - transfers via raw (physical) device mechanism. 

-d Report activity for each block device, e. g.. disk or tape drive: 

%busy, avque — portion of time device was busy servicing a transfer 
request, average number of requests outstanding during that time; 
r+w/s. blks/s - number of data transfers from or to device, number 
of bytes transferred in 512 byte units; 

avwait, avserv - average time in ms. that transfer requests wait idly 
on queue, and average time to be serviced (which for disks includes 
seek, rotational latency and data transfer times). 

—y Report TTY device activity: 

rawch/s. canch/s, outch/s - input character rate, input character 
rate processed by canon, output character rate; 

rcvin/s, xmtin/s, mdmin/s - receive, transmit and modem interrupt 
rates. 

—c Report system calls: 

scall/s — system calls of all types; 

sread/s, swrit/s, fork/s. exec/s - specific system calls; 

rchar/s, wchar/s - characters transferred by read and write system 

calls. 

—w Report system swapping and switching activity: 

swpin/s, swpot/s. bswin/s. bswot/s - number of transfers and 
number of 512 byte units transferred for swapins (including initial 
loading of some programs) and swapouts; 
pswch/s — process switches. 
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—a Report use of file access system routines: 
iget/s, namei/s, dirblk/s. 

—q Report average queue length while occupied, and 7, of time occupied: 
runq*sz, JSrunocc — run queue of processes in memory and runnable; 
swpq-sz. %swpocc - swap queue of processes swapped out but ready 
to run. 

—v Report status of text, process, inode and file tables: 

text-sz, proc-sz, inod-sz, file-sz - entries/size for each table, 
evaluated once at sampling point; 

text-ov, proc-ov, inod-ov, file*ov — overflows occurring between sam¬ 
pling points. 

—m Report message and semaphore activities: 

msg/s, sema/s - primitives per second. 

—A Report all data. Equivalent to —udqbwcayvm. 

EXAMPLES 

To see today’s CPU activity so far: 
sar 

To watch CPU activity evolve for 10 minutes and save data: 
sar —o temp 60 10 

To later review disk and tape activity from that period: 
sar -d -f temp 

FILES 

/usr/adm/sa/sa dd daily data file, where dd are digits representing the 
day of the month. 

SEE ALSO 

sag(lG), sar(8). 
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NAME 


sccsdiff - compare two versions of an SCCS file 


SYNOPSIS r , r i 

sccsdiff -rSIDl -r5ID2 [-p] [-*n] files 

DESCRIPTI^ compares two versions of an SCCS file and generates the 
differences between the two versions. Any number of SCCS files may be 
specified, but arguments apply to all files. 

—tSIIF. SID1 and SID2 specify the deltas of an SCCS file that are 
to be compared. Versions are passed to bdijf(l) in the 

order given. 

—p pipe output for each file through p r (l)- 

-sn n is the file segment size that bdiff will pass to diff (l). 

This is useful when diff fails due to a high system load. 


FILES 

/tmp/get????? Temporary files 


SEE ALSO 

bdiff(l). get(l). help(l). pr(l). . „ _ . ~ . 

Source Code Control System User's Guide by L. E. Bonanni and C. A. 

Salemi. 


DIAGNOSTICS . 

•■file: No differences” If the two versions are the same 

Use help(l) for explanations. 
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NAME 

script — make typescript of terminal session 
SYNOPSIS 

script [ — a ] [ file ] 

DESCRIPTION 

Script makes a typescript of everything printed on your terminal. The 
typescript is written lo file, or appended to file if the —a option is given. 
It can be sent to the line printer later with Ipr. If no file name is given, 
the typescript is saved in the file typescript. 

The script ends when the forked shell exits. 

This program is useful when using a crt and a hard*copy record of the 
dialog is desired, as for a student handing in a program that was 
developed on a crt when hard-copy terminals are in short supply. 

BUGS 

Script places everything in the log file. This is not what the naive user 
expects. 
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NAME 

sdifT - side-by-side difference program 
SYNOPSIS 

sdiff [ options ... ] filel file2 
DESCRIPTION 

Sdiff uses the output of diff(\) to produce a side-by-side listing of two 
files indicating those lines that are different. Each line of the two files is 
printed with a blank gutter between them if the lines are identical, a < in 
the gutter if the line only exists in filel, a > in the gutter if the line only 
exists in file2, and a | for lines that are different. 

For example: 

x | y 

a a 

b < 

c < 

d d 

> c 

The following options exist: 

—•w n Use the next argument, n, as the width of the output line. The 
default line length is 130 characters. 

—1 Only print the left side of any lines that are identical. 

—s Do not print identical lines. 

—o output 

Use the next argument, output, as the name of a third file that 
is created as a user controlled merging of filel and file2. 
Identical lines of filel and file2 are copied to oufpuf. Sets of 
differences, as produced by diff(l), are printed; where a set of 
differences share a common gutter character. After printing 
each set of differences, sdiff prompts the user with a X and 
waits for one of the following user-typed commands: 

1 append the left column to the output file 
r append the right column to the output file 

s turn on silent mode; do not print identical lines 

▼ turn off silent mode 

e 1 call the editor with the left column 

e r call the editor with the right column 

e b call the editor with the concatenation of left and 
right 

e call the editor with a zero length file 
q exit from the program 

On exit from the editor, the resulting file is concatenated on 
the end of the output file. 
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SEE ALSO 

difT(l), ed(l). 
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NAME 

sed — stream editor 
SYNOPSIS 

sed [ -n ] [ -e script ] [ -f sfile ] [ files ] 

DESCRIPTION 

Sed copies the named files (standard input default) to the standard out¬ 
put, edited according to a script of commands. The —f option causes the 
script to be taken from file sfile: these options accumulate. If there is 
just one —e option and no —f options, the flag —e may be omitted. The —n 
option suppresses the default output. A script consists of editing com¬ 
mands. one per line, of the following form: 

[ address [ , address ] ] function [ arguments ] 

In normal operation, sed cyclically copies a line of input into a pattern 
space (unless there is something left after a D command), applies in 
sequence all commands whose addresses select that pattern space, and 
at the end of the script copies the pattern space to the standard output 
(except under —n) and deletes the pattern space. 

Some of the commands use a hold space to save all or part of the pattern 
space for subsequent retrieval. 

An address is either a decimal number that counts input lines cumula¬ 
tively across files, a S that addresses the last line of input, or a context 
address, i.e., a /regular expression/ in the style of ed(l) modified thus: 

In a context address, the construction \?regular expression ?. 
where ? is any character, is identical to /regular expres¬ 
sion/. Note that in the context address \xabc\xdefx, the 
second x stands for itself, so that the regular expression is 
abcxdef. 

The escape sequence \n matches a new-line embedded in the pat¬ 
tern space. 

A period . matches any character except the terminal new-line of 
the pattern space. 

A command line with no addresses selects every pattern space. 

A command line with one address selects each pattern space that 
matches the address. 

A command line with two addresses selects the inclusive range 
from the first pattern space that matches the first address 
through the next pattern space that matches the second. 
(If the second address is a number less than or equal to the 
line number first selected, only one line is selected.) 
Thereafter the process is repeated, looking again for the 
first address. 

Editing commands can be applied only to non-selected pattern spaces by 
use of the negation function ! (below). 

In the following list of functions the maximum number of permissible 
addresses for each function is indicated in parentheses. 

The text argument consists of one or more lines, all but the last of which 
end with \ to hide the new-line. Backslashes in text are treated like 
backslashes in the replacement string of an s command, and may be used 
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to protect initial blanks and tabs against the stripping that is done on 
every script line. The rfile or wfile argument must terminate the com¬ 
mand line and must be preceded by exactly one blank. Each wfile is 
created before processing begins. There can be at most 10 distinct wfile 
arguments. 


(1) a\ 

text Append. Place text on the output before reading the next input 
line. 

(2) b label 

Branch to the : command bearing the label. If label is empty, 
branch to the end of the script. 


(2) c\ 
text 


Change. Delete the pattern space. With 0 or 1 address or at the 
end of a 2-address range, place text on the output. Start the 
next cycle. 

Delete the pattern space. Start the next cycle. 

Delete the initial segment of the pattern space through the first 
new-line. Start the next cycle. 

Replace the contents of the pattern space by the contents of 
the hold space. 

Append the contents of the hold space to the pattern space. 
Replace the contents of the hold space by the contents of the 
pattern space. 

Append the contents of the pattern space to the hold space. 
Insert. Place text on the standard output. 

List the pattern space on the standard output in an unambigu¬ 
ous form. Non-printing characters are spelled in two-digit ASCII 
and long lines are folded. 

Copy the pattern space to the standard output. Replace the 
pattern space with the next line of input. 

Append the next line of input to the pattern space with an 
embedded new-line. (The current line number changes.) 

Print. Copy the pattern space to the standard output. 

Copy the initial segment of the pattern space through the first 
new-line to the standard output. 

(1) q Quit. Branch to the end of the script. Do not start a new cycle. 

(2) r rfile 

Read the contents of rfile. Place them on the output before 
reading the next input line. 

(2) s/regular expression /replacement /flags 

Substitute the replacement string for instances of the regular 
expression in the pattern space. Any character may be used 
instead of /. For a fuller description see ed(l). Flags is zero or 
more of: 

g Global. Substitute for all nonoverlapping 
instances of the regular expression rather than 
just the first one. 

p Print the pattern space if a replacement was 
made. 


(2) d 
(2)D 

(2)g 

(2) G 
(2) h 

(2)H 

(Di\ 

text 

( 2)1 


(2) n 
(2) N 

(2) p 

(2) P 
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w wfile 

Write. Append the pattern space to wfile if a 
replacement was made. 

(2) t label 


Test. Branch to the : command bearing the label if any substi¬ 
tutions have been made since the most recent reading of an 
input line or execution of a t. If label is empty, branch to the 
end of the script. 

(2) w wfile 

Write. Append the pattern space to wfile. 

(2) x Exchange the contents of the pattern and hold spaces. 

(2) y/ string 1 /string2/ 

Transform. Replace all occurrences of characters in string 1 
with the corresponding character in string2. The lengths of 
string 1 and string2 must be equal. 

(2)! function 

Don’t. Apply the function (or group, if function is [) only to 
lines not selected by the address(es). 


(0) :label 

This command does nothing; it bears a label for b and t com¬ 
mands to branch to. 

(1) = Place the current line number on the standard output as a line. 

(2) | Execute the following commands through a matching { only 

when the pattern space is selected. 

(0) An empty command is ignored. 


SEE ALSO 

awk(l), ed(l), grep(l). 
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NAME 

send — gather files and submit RJE jobs 
SYNOPSIS 

send argument ... 

DESCRIPTION 

Send is a command-level interface to the RJE subsystems. It allows the 
user to collect input from various sources in order to create a run 
stream consisting of card images, and submit this run stream for 
transmission to a host computer. 

Possible sources of input to send are: ordinary files, standard input, the 
terminal, and the output of a command or shell file. Each source of 
input is treated as a virtual file, and no distinction is made based upon 
its origin. Typical input is an ASCII text file of the sort that is created by 
the editor ed(l). An optional format specification appearing in the first 
line of a file (see /spec (5)) determines the settings according to which 
tabs are expanded into spaces. In addition, lines that begin with ~ are 
normally interpreted as commands controlling the execution of send. 
They may be used to set or reset flags, to define keyword substitutions, 
and to open new sources of input in the midst of the current source. 
Other text lines are translated one-for-one into card images of the run 
stream. 

The run stream that results from this collection is treated as one job by 
the RJE subsystems. Send prints the card count of the run stream, and 
the queuer that is invoked prints the name of the temporary file that 
holds the job while it is awaiting transmission. The initial card of a job 
submitted to an IBM host must have a // in the first column. The initial 
card of a job submitted to a UNIVAC host must begin with a "©RUN" or 
"'run", etc. Any cards preceding these will be excised. If a host com¬ 
puter is not specified before the first card of the runstream is ready to 
be sent, send will select a reasonable default. In the case of an IBM job, 
all cards beginning with /*S will be excised from the runstream, because 
they are HASP command cards. 

The arguments that send accepts are described below. An argument is 
interpreted according to the first pattern that it matches. Preceding a 
character with \ causes it to loose any special meaning it might other¬ 
wise have when matching against an argument pattern. 


. 

Close the current source. 

- 

Open standard input as a new source. 

+ 

Open the terminal as a new source. 

:spec: 

Establish a default format specification for included 

sources, 

e.g., :m6t—12: 

r message 

Print message on the terminal. 

prompt 

Open standard input and, if it is a terminal, print 
prompt. 

+prompt 

Open the terminal and print prompt. 
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—flags 
+flags 
=flags 


'command 


Xline 


@directory 


Set the specified flags, which are described below. 
Reset the specified flags. 

Restore the specified flags to their state at the pre¬ 
vious level. 

Execute the specified UNIX command via the one- 
line shell, with input redirected to /dev/null as a 
default. Open the standard output of the command 
as a new source. 

Collect contiguous arguments of this form and write 
them as consecutive lines to a temporary file; then 
have the file executed by the shell. Open the stan¬ 
dard output of the shell as a new source. 

The current directory for the send process is 
changed to directory. The original directory will be 
restored at the end of the current source. 


~comment 
?:keyword 

?keyword=xx 


Ignore this argument. 

Prompt for a definition of keyword from the termi¬ 
nal unless keyword has an existing definition. 

Define the keyword as a two digit hexadecimal char¬ 
acter code unless it already has a non null replace¬ 
ment. 


?keyword=string Define the keyword in terms of a replacement string 
unless it already has a non null replacement. 

=:keyword Prompt for a definition of keyword from the termi¬ 

nal. 


keyword—xx 


Define keyword as a two-digit hexadecimal charac¬ 
ter code. 


keyword=string 

host 


Define keyword in terms of a replacement string. 

The host machine that the job should be submitted 
to. It can be any name that corresponds to one in 
the first column of the RJE configuration file 
(/usr/rje/lines). 

file-name Open the specified file as a new source of input. 

When commands are executed via S or ! the shell environment (see 
environ( 7)) will contain the values of all send keywords that begin with 
X and have the syntax of a shell variable. 


The flags recognized by send are described in terms of the special pro¬ 
cessing that occurs when they are set: 

—1 List card images on standard output. EBCDIC characters are 
translated back to ASCII. 


—q Do not output card images. 

—f Do not fold lower case to upper. 

—t Trace progress on diagnostic output, by announcing the opening 
of input sources. 
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—k Ignore the keywords that are active at the previous level and 
erase any keyword definitions that have been made at the 
current level. 

—r Process included sources in raw mode; pack arbitrary 8-bit bytes 
one per column (80 columns per card) until an EOF. 

—i Do not interpret control lines in included sources; treat them as 
text. 

s Make keyword substitutions before detecting and interpreting 
control lines. 

—y Suppress error diagnostics and submit job anyway. 

-g Gather mode, qualifying -1 flag; list text lines before converting 
them to card images. 

—h Write listing with standard tabs. 

—p Prompt with • when taking input from the terminal. 

—m When input returns to the terminal from a lower level, repeat the 
prompt, if any. 

—a Make —k flag propagate to included sources, thereby protecting 
them from keyword substitutions. 

—c List control lines on diagnostic output. 

—d Extend the current set of keyword definitions by adding those 
active at the end of included sources. 

—x This flag guarantees that the job will be transmitted in the order 
of submission (relative to other jobs sent with this flag). 

Control lines are input lines that begin with ~. In the default mode 
+ir, they are interpreted as commands to send. Normally they are 
detected immediately and read literally. The —s flag forces keyword 
substitutions to be made before control lines are intercepted and 
interpreted. This can lead to unexpected results if a control line 
uses a keyword which is defined within an immediately preceding ~S 
sequence. Arguments appearing in control lines are handled exactly 
like the command arguments to send, except that they are processed 
at a nested level of input. 

The two possible formats for a control line are: "‘■'■'argument” and 
argument In the first case, where the ~ is not followed by a 
space, the remainder of the line is taken as a single argument to 
send. In the second case, the line is parsed to obtain a sequence of 
arguments delimited by spaces. In this case the quotes * and " may 
be employed to pass embedded spaces. 

The interpretation of the argument . is chosen so that an input line 
consisting of is treated as a logical EOF. The following example 
illustrates some of the above conventions: 

send — 

~ argument ... 
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This sequence of three lines is equivalent to the command synopsis at 
the beginning of this description. In fact, the — is not even required. 
By convention, the send command reads standard input if no other 
input source is specified. Send may therefore be employed as a filter 
with side-effects. 

The execution of the send command is controlled at each instant by 
a current environment, which includes the format specification for 
the input source, a default format specification for included sources, 
the settings of the mode flags, and the active set of keyword 
definitions. This environment can be altered dynamically. When a 
control line opens a new source of input, the current environment is 
pushed onto a stack, to be restored when input resumes from the old 
source. The initial format specification for the new source is taken 
from the first line of the file. If none is provided, the established 
default is used or, in its absence, standard tabs. The initial mode set¬ 
tings and active keywords are copied from the old environment. 
Changes made while processing the new source will not affect the 
environment of the old source, with one exception: if —d mode is set 
in the old environment, the old keyword context will be augmented by 
those definitions that are active at the end of the new source. 

When send first begins execution, all mode flags are reset, and the 
values of the shell environment variables become the initial values 
for keywords of the same name with a S prefixed. 

The initial reset state for all mode flags is the + state. In general, 
special processing associated with a mode N is invoked by flag —N and 
is revoked by flag +N. Most mode settings have an immediate effect 
on the processing of the current source. Exceptions to this are the 
—r and —i flags, which apply only to included source, causing it to be 
processed in an uninterpreted manner. 

A keyword is an arbitrary 8-bit ASCII string for which a replacement 
has been defined. The replacement may be another string, or (for IBM 
RJE only) the hexadecimal code for a single 8-bit byte. At any 
instant, a given set of keyword definitions is active. Input text lines 
are scanned, in one pass from left to right, and longest matches are 
attempted between substrings of the line and the active set of key¬ 
words. Characters that do not match are output, subject to folding 
and the standard translation. Keywords are replaced by the specified 
hexadecimal code or replacement string, which is then output char¬ 
acter by character. The expansion of tabs and length checking, 
according to the format specification of an input source, are delayed 
until substitutions have been made in a line. 

All of the keywords definitions made in the current source may be 
deleted by setting the — k flag. It then becomes possible to reuse 
them. Setting the —k flag also causes keyword definitions active at 
the previous source level to be ignored. Setting the +k flag causes 
keywords at the previous level to be ignored but does not delete the 
definitions made at the current level. The =k argument reactivates 
the definitions of the previous level. 
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When keywords are redefined, the previous definition at the same 
level of source input is lost, however the definition at the previous 
level is only hidden, to be reactivated upon return to that level unless 
a —d flag causes the current definition to be retained. 

Conditional prompts for keywords. ?:A, /p which have already been 
defined at some higher level to be null or have a replacement will sim¬ 
ply cause the definitions to be copied down to the current level; new 
definitions will not be solicited. 

Keyword substitution is an elementary macro facility that is easily 
explained and that appears useful enough to warrant its inclusion in 
the send command. More complex replacements are the function of 
a general macro processor (m4( 1), perhaps). To reduce the overhead 
of string comparison, it is recommended that keywords be chosen so 
that their initial characters are unusual. For example, let them all 
be upper case. 

Send performs two types of error checking on input text lines. 
Firstly, only ASCII graphics and tabs are permitted in input text. 
Secondly, the length of a text line, after substitutions have been 
made, may not exceed 80 bytes for IBM, or 132 bytes for UNIVAC. The 
length of each line may be additionally constrained by a size parame¬ 
ter in the format specification for an input source. Diagnostic output 
provides the location of each erroneous line, by line number and 
input source, a description of the error, and the card image that 
results. Other routine errors that are announced are the inability to 
open or write files, and abnormal exits from the shell. Normally, the 
occurrence of any error causes send, before invoking the queuer, to 
prompt for positive affirmation that the suspect run stream should be 
submitted. 

For IBM hosts, send is required to translate 8-bit ASCII characters into 
their EBCDIC equivalents. The conversion for 8-bit ASCII characters in 
the octal range 040-176 is based on the character set described in 
“Appendix H" of IBM System/370 Principles of Operation (IBM SRL 
GA22-7000). Each 8-bit ASCII character in the range 040-377 
possesses an EBCDIC equivalent into which it is mapped, with five 
exceptions: ~ into -, 0345 into ~, 0325 into *, 0313 into |, 0177 (DEL) 
is illegal. In listings requested from send and in printed output 
returned by the subsystem, the reverse translation is made with the 
qualification that EBCDIC characters that do not have valid 8-bit ASCII 
equivalents are translated into UNIVAC hosts, on the other hand, 
operate in ASCII code, and any translations between ASCII and field- 
data are made, in accordance with the UNIVAC standard, by the host 
computer. 

Additional control over the translation process is afforded by the -f 
flag and hexadecimal character codes. As a default, send folds 
lower-case letters into upper case. For UNIVAC RJE it does more: the 
entire ASCII range 0140-0176 is folded into 0100-0136, so that \ for 
example, becomes @. In either case, setting the —I flag inhibits any 
folding. Non-standard character codes are obtained as a special case 
of keyword substitution. 
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SEE ALSO 

m4(l), rjestat(lC), sh(l), fspec(5), ascii(7), rje(8). 

Guide to IBM Remote Job Entry for PWB/UNIX Users by A. L. Sabsevitz and 
E. J. Finger. 

UNIX Remote Job Entry User's Guide by K. A. Kelleman. 

BUGS 

Standard input is read in blocks, and unused bytes are returned via 
lseek(2). If standard input is a pipe, multiple arguments of the form — 
and —-.prompt should not be used, nor should the logical EOF 
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NAME 

sh. rsh - shell, the standard/restricted command programming language 
SYNOPSIS 

sh [ -ceiknrstuvx ] [ args ] 
rsh [ —ceiknrstuvx ] [ args ] 

DESCRIPTION 

Sh is a command programming language that executes commands read 
from a terminal or a file. fish is a restricted version of the standard 
command interpreter sh; it is used to set up login names and execution 
environments whose capabilities are more controlled than those of the 
standard shell. See Invocation below for the meaning of arguments to 
the shell. 

Commands. 

A simple-command is a sequence of non-blank words separated by 
blanks (a blank is a tab or a space). The first word specifies the name of 
the command to be executed. Except as specified below, the remaining 
words are passed as arguments to the invoked command. The command 
name is passed as argument 0 (see exec (2)). The value of a simple- 
command is its exit status if it terminates normally, or (octal) 
200+sfafus if it terminates abnormally (see signal(2 ) for a list of status 
values). 

A pipeline is a sequence of one or more commands separated by | (or, for 
historical compatibility, by ~). The standard output of each command 
but the last is connected by a pipe(2) to the standard input of the next 
command. Each command is run as a separate process; the shell waits 
for the last command to terminate. 

A list is a sequence of one or more pipelines separated by ;, k, kk, or ||, 
and optionally terminated by ; or k. Of these four symbols. ; and k have 
equal precedence, which is lower than that of kk and ||. The symbols kk 
and || also have equal precedence. A semicolon (;) causes sequential exe¬ 
cution of the preceding pipeline; an ampersand (&) causes asynchronous 
execution of the preceding pipeline (i.e., the shell does not wait for that 
pipeline to finish). The symbol kk (||) causes the list following it to be 
executed only if the preceding pipeline returns a zero (non-zero) exit 
status. An arbitrary number of new-lines may appear in a list, instead of 
semicolons, to delimit commands. 

A command is either a simple-command or one of the following. Unless 
otherwise stated, the value returned by a command is that of the last 
simple-command executed in the command. 

for name [ in word ... ] do list done 

Each time a for command is executed, name is set to the next 
word taken from the in word list. If in word ... is omitted, then 
the for command executes the do list once for each positional 
parameter that is set (see Parameter Substitution below). Execu¬ 
tion ends when there are no more words in the list, 
case word in [ pattern [ | pattern ] ... ) list ;; ) ... esac 

A case command executes the list associated with the first pattern 
that matches word. The form of the patterns is the same as that 
used for file-name generation (see File Name Generation below). 
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if list then list [ elif list then list ] ... [ else list ] fi 

The list following if is executed and, if it returns a zero exit status, 
the list following the first then is executed. Otherwise, the list fol¬ 
lowing elif is executed and, if its value is zero, the list following 
the next then is executed. Failing that, the else List is executed. 
If no else list or then list is executed, then the if command 
returns a zero exit status, 
while list do list done 

A while command repeatedly executes the while list and, if the exit 
status of the last command in the list is zero, executes the do list-, 
otherwise the loop terminates. If no commands in the do list are 
executed, then the while command returns a zero exit status; until 
may be used in place of while to negate the loop termination test. 

(list) 

Execute list in a sub-shell. 
list is simply executed. 

The following words are only recognized as the first word of a command 
and when not quoted: 

if then else elif fi case esac for while until do done ( j 

Comments. 

A word beginning with $ causes that word and all the following characters 
up to a new-line to be ignored. 

Command Substitution. 

The standard output from a command enclosed in a pair of grave accents 
(") may be used as part or all of a word; trailing new-lines are removed. 

Parameter Substitution. 

The character S is used to introduce substitutable parameters. Posi¬ 
tional parameters may be assigned values by set. Variables may be set 
by writing: 

name —value [ name —value ] ... 

Pattern-matching is not performed on value. 
t\parameter\ 

A parameter is a sequence of letters, digits, or underscores (a 
name), a digit, or any of the characters ♦. @, #, ?, — . S, and !. The 
value, if any, of the parameter is substituted. The braces are 
required only when parameter is followed by a letter, digit, or 
underscore that is not to be interpreted as part of its name. A 
name must begin with a letter or underscore. If parameter is a 
digit then it is a positional parameter. If parameter is * or @, then 
all the positional parameters, starting with Si, are substituted 
(separated by spaces). Parameter SO is set from argument zero 
when the shell is invoked. 

%\parameter:—word\ 

If parameter is set and is non-null then substitute its value; other¬ 
wise substitute word. 

%\parameter:=word } 

If parameter is not set or is null then set it to word, the value of 
the parameter is then substituted. Positional parameters may not 
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be assigned to in this way. 
t[parameter:?word j 

If parameter is set and is non-null then substitute its value; other¬ 
wise. print word and exit from the shell. If word is omitted, then 
the message ’’parameter null or not set” is printed. 

%\paramet er:+word j 

If parameter is set and is non-null then substitute word: otherwise 
substitute nothing. 

In the above, word is not evaluated unless it is to be used as the substi¬ 
tuted string, so that, in the following example, pwd is executed only if d is 
not set or is null: 

echo S{d:— x pwd' j 

If the colon (:) is omitted from the above expressions, then the shell only 
checks whether parameter is set or not. 

The following parameters are automatically set by the shell: 

# The number of positional parameters in decimal. 

— Flags supplied to the shell on invocation or by the set com¬ 
mand. 

? The decimal value returned by the last synchronously exe¬ 
cuted command. 

S The process number of this shell. 

! The process number of the last background command 
invoked. 

The following parameters are used by the shell: 

HOUE The default argument (home directory) for the cd com¬ 
mand. 

PATH The search path for commands (see Execution below). The 
user may not change PATH if executing under rsh. 

CDPATH 

The search path for the cd command. 

KAIL If this variable is set to the name of a mail file, then the 
shell informs the user of the arrival of mail in the specified 
file. 

PS1 Primary prompt string, by default "S ". 

PS2 Secondary prompt string, by default "> ". 

IFS Internal field separators, normally space, tab, and new-line. 

The shell gives default values to PATH, PS1, PS2, and IFS, while HOUE and 
1LAIL are not set at all by the shell (although HOUE is set by foyin(l)). 

Blank Interpretation. 

After parameter and command substitution, the results of substitution 
are scanned for internal field separator characters (those found in IFS) 
and split into distinct arguments where such characters are found. 
Explicit null arguments (’”’ or ") are retained. Implicit null arguments 
(those resulting from parameters that have no values) are removed. 

File Name Generation. 

Following substitution, each command word is scanned for the charac¬ 
ters •, ?, and [. If one of these characters appears then the word is 
regarded as a pattern. The word is replaced with alphabetically sorted 
file names that match the pattern. If no file name is found that matches 
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the pattern, then the word is left unchanged. The character . at the 
start of a file name or immediately following a /, as well as the character 
/ itself, must be matched explicitly. 

• Matches any string, including the null string. 

? Matches any single character. 

[...] Matches any one of the enclosed characters. A pair of 
characters separated by — matches any character lexically 
between the pair, inclusive. If the first character following 
the opening "[" is a **!’* then any character not enclosed is 
matched. 


Quoting. 

The following characters have a special meaning to the shell and cause 
termination of a word unless quoted: 

; & ( ) | ~ < > new-line space tab 

A character may be quoted (i.e., made to stand for itself) by preceding it 
with a V The pair \ new-line is ignored. All characters enclosed between 
a pair of single quote marks ("). except a single quote, are quoted. 
Inside double quote marks ("*'). parameter and command substitution 
occurs and \ quotes the characters \, ', ", and S. "%*" is equivalent to 
"SI S2 ...", whereas "S@" is equivalent to "SI" "S2" .... 

Prompting. 

When used interactively, the shell prompts with the value of PS1 before 
reading a command. If at any time a new-line is typed and further input 
is needed to complete a command, then the secondary prompt (i.e., the 
value of PS2) is issued. 


Input/Output. 

Before a command is executed, its input and output may be redirected 
using a special notation interpreted by the shell. The following may 
appear anywhere in a simple-command or may precede or follow a com¬ 
mand and are not passed on to the invoked command; substitution 
occurs before word or digit is used: 


<word 

>word 


»word 


«[ — ]word 


<&digit 


Use file word as standard input (file descriptor 0). 

Use file word as standard output (file descriptor 1). If the 
file does not exist then it is created; otherwise, it is trun¬ 
cated to zero length. 

Use file word as standard output. If the file exists then out¬ 
put is appended to it (by first seeking to the end-of-file); 
otherwise, the file is created. 

The shell input is read up to a line that is the same as word, 
or to an end-of-file. The resulting document becomes the 
standard input. If any character of word is quoted, then no 
interpretation is placed upon the characters of the docu¬ 
ment; otherwise, parameter and command substitution 
occurs, (unescaped) \ new-line is ignored, and \ must be 
used to quote the characters \, S, ', and the first character 
of word. If — is appended to «, then all leading tabs are 
stripped from word and from the document. 

The standard input is duplicated from file descriptor digit 
(see dup( 2)). Similarly for the standard output using >. 
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<tc— The standard input is closed. Similarly for the standard 

output using >. 

If one of the above is preceded by a digit, then the file descriptor created 
is that specified by the digit (instead of the default 0 or 1). For example: 

... 2>&1 

creates file descriptor 2 that is a duplicate of file descriptor 1. 

If a command is followed by Ic then the default standard input for the 
command is the empty file /dev/null. Otherwise, the environment for the 
execution of a command contains the file descriptors of the invoking 
shell as modified by input/output specifications. 

Redirection of output is not allowed in the restricted shell. 

Environment. 

The environment (see environ(7)) is a list of name-value pairs that is 
passed to an executed program in the same way as a normal argument 
list. The shell interacts with the environment in several ways. On invoca¬ 
tion, the shell scans the environment and creates a parameter for each 
name found, giving it the corresponding value. Executed commands 
inherit the same environment. If the user modifies the values of these 
parameters or creates new ones, none of these affects the environment 
unless the export command is used to bind the shell's parameter to the 
environment. The environment seen by any executed command is thus 
composed of any unmodified name-value pairs originally inherited by the 
shell, plus any modifications or additions, all of which must be noted in 
export commands. 

The environment for any simple-command may be augmented by 
prefixing it with one or more assignments to parameters. Thus: 

TERM=450 cmd args and 

(export TERM; TERM=450; cmd args) 

are equivalent (as far as the above execution of cmd is concerned). 

If the — k flag is set, all keyword arguments are placed in the environ¬ 
ment, even if they occur after the command name. The following first 
prints a=b c and then c: 

echo a=b c 
set —k 
echo a=b c 

Signals. 

The INTERRUPT and QUIT signals for an invoked command are ignored if 
the command is followed by tc, otherwise signals have the values inher¬ 
ited by the shell from its parent, with the exception of signal 11 (but see 
also the trap command below). 

Execution. 

Each time a command is executed, the above substitutions are carried 
out. Except for the Special Commands listed below, a new process is 
created and an attempt is made to execute the command via ezec(2). 

The shell parameter PATH defines the search path for the directory con¬ 
taining the command. Alternative directory names are separated by a 
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colon (:). The default path is :/bin:/usr/bin (specifying the current 
directory, /bin, and /usr/bin, in that order). Note that the current 
directory is specified by a null path name, which can appear immediately 
after the equal sign or between the colon delimiters anywhere else in the 
path list. If the command name contains a / then the search path is not 
used; such commands will not be executed by the restricted shell. Other¬ 
wise. each directory in the path is searched for an executable file. If the 
file has execute permission but is not an a.out file, it is assumed to be a 
file containing shell commands. A sub-shell (i.e., a separate process) is 
spawned to read it. A parenthesized command is also executed in a sub¬ 
shell. 

Special Commands. 

The following commands are executed in the shell process and, except as 
specified, no input/output redirection is permitted for such commands; 

: No effect; the command does nothing. A zero exit code is 

returned. 

. file Read and execute commands from file and return. The search 
path specified by PATH is used to find the directory containing file. 
break [ n ] 

Exit from the enclosing for or while loop, if any. If n is specified 
then break n levels, 
continue [ n ] 

Resume the next iteration of the enclosing for or while loop. If n 
is specified then resume at the n-th enclosing loop, 
cd [ arg ] 

Change the current directory to arg. The shell parameter HOUE is 
the default arg. The shell parameter CDPATH defines the search 
path for the directory containing arg. Alternative directory 
names are separated by a colon (:). The default path is <null> 
(specifying the current directory). Note that the current direc¬ 
tory is specified by a null path name, which can appear immedi¬ 
ately after the equal sign or between the colon delimiters any¬ 
where else in the path list. If arg begins with a / then the search 
path is not used. Otherwise, each directory in the path is 
searched for arg. The cd command may not be executed by rsh. 
eval [ arg ... ] 

The arguments are read as input to the shell and the resulting 
command(s) executed, 
exec [ arg ... ] 

The command specified by the arguments is executed in place of 
this shell without creating a new process. Input/output argu¬ 
ments may appear and, if no other arguments are given, cause the 
shell input/output to be modified, 
exit [ n ] 

Causes a shell to exit with the exit status specified by n. If n is 
omitted then the exit status is that of the last command executed 
(an end-of-file will also cause the shell to exit.) 
export [ name ... ] 

The given names are marked for automatic export to the environ¬ 
ment of subsequently-executed commands. If no arguments are 
given, then a list of all names that are exported in this shell is 
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printed. 

newgrp [ arg ... ] 

Equivalent to exec newgrp arg .... 
read [ name ... ] 

One line is read from the standard input and the first word is 
assigned to the first name, the second word to the second name, 
etc., with leftover words assigned to the last name. The return 
code is 0 unless an end-of-file is encountered, 
readonly [ name ... ] 

The given names are marked readonly and the values of the these 
names may not be changed by subsequent assignment. If no argu¬ 
ments are given, then a list of all readonly names is printed, 
set [ —ekntuvx [ arg ... ] ] 

—e Exit immediately if a command exits with a non-zero exit 

status. 

—k All keyword arguments are placed in the environment for a 

command, not just those that precede the command name. 

—n Read commands but do not execute them. 

—t Exit after reading and executing one command. 

—u Treat unset variables as an error when substituting. 

—v Print shell input lines as they are read. 

—x Print commands and their arguments as they are executed. 

— Do not change any of the fiags; useful in setting Si to —. 

Using + rather than — causes these flags to be turned off. These 
flags can also be used upon invocation of the shell. The current 
set of flags may be found in S—. The remaining arguments are 

positional parameters and are assigned, in order, to Si, S2. If 

no arguments are given then the values of all names are printed, 
shift [ n ] 

The positional parameters from Sn+1 ... are renamed Si — If n 
is not given, it is assumed to be 1. 

test 

Evaluate conditional expressions. See fesf(l) for usage and 
description. 

times 

Print the accumulated user and system times for processes run 
from the shell, 
trap [ arg ] [ n ] ... 

arg is a command to be read and executed when the shell receives 
signal(s) n. (Note that arg is scanned once when the trap is set 
and once when the trap is taken.) Trap commands are executed in 
order of signal number. Any attempt to set a trap on a signal that 
was ignored on entry to the current shell is ineffective. An 
attempt to trap on signal 11 (memory fault) produces an error. If 
arg is absent then all trap(s) n are reset to their original values. 
If arg is the null string then this signal is ignored by the shell and 
by the commands it invokes. If n is 0 then the command arg is 
executed on exit from the shell. The trap command with no argu¬ 
ments prints a list of commands associated with each signal 
number. 

ulimit [ —fp ] [ n ] 

imposes a size limit of n 
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—f imposes a size limit of n blocks on files written by child 

processes (files of any size may be read). With no argument, 
the current limit is printed. 

—p changes the pipe size to n (UNIX System/RT only). 

If no option is given, —f is assumed, 
umask [ nnn ] 

The user file-creation mask is set to nnn (see umask(2)). If nnn is 
omitted, the current value of the mask is printed, 
wait [ n ] 

Wait for the specified process and report its termination status. If 
n is not given then all currently active child processes are waited 
for and the return code is zero. 

Invocation. 

If the shell is invoked through exec (2) and the first character of argu¬ 
ment zero is —, commands are initially read from /etc /profile and then 
from SHOME/. pro file, if such files exist. Thereafter, commands are read 
as described below, which is also the case when the shell is invoked as 
/bin/sh. The flags below are interpreted by the shell on invocation only; 
Note that unless the —c or —s flag is specified, the first argument is 
assumed to be the name of a file containing commands, and the remain¬ 
ing arguments are passed as positional parameters to that command file: 

—c string 

If the —c flag is present then commands are read from string. 

—s If the —s flag is present or if no arguments remain then com¬ 

mands are read from the standard input. Any remaining argu¬ 
ments specify the positional parameters. Shell output is writ¬ 
ten to file descriptor 2. 

—i If the —i flag is present or if the shell input and output are 

attached to a terminal, then this shell is interactive. In this 
case TERMINATE is ignored (so that kill 0 does not kill an interac¬ 
tive shell) and INTERRUPT is caught and ignored (so that wait is 
interruptible). In all cases, QUIT is ignored by the shell. 

—r If the —r flag is present the shell is a restricted shell. 

The remaining flags and arguments are described under the set com¬ 
mand above. 

Rsh Only. 

Rsh is used to set up login names and execution environments whose 
capabilities are more controlled than those of the standard shell. The 
actions of rsh are identical to those of sh, except that the following are 
disallowed: 

changing directory (see cd(l)), 
setting the value of SPATH. 

specifying path or command names containing /, 
redirecting output (> and >>). 

The restrictions above are enforced after .profile is interpreted. 

When a command to be executed is found to be a shell procedure, rsh 
invokes sh to execute it. Thus, it is possible to provide to the end-user 
shell procedures that have access to the full power of the standard shell, 
while imposing a limited menu of commands; this scheme assumes that 
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the end-user does not have write and execute permissions in the same 
directory. 

The net effect of these rules is that the writer of the .profile has com¬ 
plete control over user actions, by performing guaranteed setup actions 
and leaving the user in an appropriate directory (probably not the login 
directory). 

The system administrator often sets up a directory of commands (i.e., 
/usr/rbin) that can be safely invoked by rsh. Some systems also provide 
a restricted editor red. 

EXIT STATUS 

Errors detected by the shell, such as syntax errors, cause the shell to 
return a non-zero exit status. If the shell is being used non-interactively 
then execution of the shell file is abandoned. Otherwise, the shell 
returns the exit status of the last command executed (see also the exit 
command above). 

FILES 

/etc/profile 
SHOME/. profile 
/tmp/sh* 

/dev/null 

SEE ALSO 

cd(l), env(l), login(l), newgrp(l), test(l), umask(l), dup(2), exec(2), 
fork(2), pipe(2), signal(2), ulimit(2), umask(2), wait(2), a.out(5), 
profile(5), environ(7). 

BUGS 

The command readonly (without arguments) produces the same output 
as the command export. 

If « is used to provide standard input to an asynchronous process 
invoked by Sc. the shell gets mixed up about naming the input document; 
a garbage file /tmp/sh* is created and the shell complains about not 
being able to find that file by another name. 
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NAME 

size — size of an object file 

SYNOPSIS 

size [ object ... ] 

DESCRIPTION 

Size prints the (decimal) number of bytes required by the text, data, bss 
and stack portions, and their sum in octal and decimal, of each object- 
file argument. If no file is specified, a.out is used. 

SEE ALSO 

a.out(5) 
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NAME 

sleep — suspend execution for an interval 

SYNOPSIS 

sleep time 

DESCRIPTION 

Sleep suspends execution for time seconds. It is used to execute a com¬ 
mand after a certain amount of time as in: 

(sleep 105; command)^ 

or to execute a command every so often, as in: 

while true 
do 

command 
sleep 37 

done 

SEE ALSO 

alarm(2), sleep(3) 

BUGS 

Time must be less than 65536 seconds. 
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NAME 

sno — SNOBOL interpreter 

SYNOPSIS 

sno [ files ] 

DESCRIPTION 

Sno is a SNOBOL compiler and interpreter (with slight differences). 9no 
obtains input from the concatenation of the named files and the stan¬ 
dard input. All input through a statement containing the label end is 
considered program and is compiled. The rest is available to syspit. 

Sno differs from SNOBOL in the following ways: 

There are no unanchored searches. To get the same effect: 

a •• b unanchored search for 6. 

a b = x cunanchored assignment 

There is no back referencing. 

x = "abc" 

a *x* x is an unanchored search for abc. 

Function declaration is done at compile time by the use of the 
(non-unique) label define. Execution of a function call begins at 
the statement following the define. Functions cannot be defined 
at run time, and the use of the name define is preempted. There is 
no provision for automatic variables other than parameters. 
Examples: 

define f( ) 
define f(a, b, c) 

All labels except define (even end) must have a non-empty state¬ 
ment. 

Labels, functions and variables must all have distinct names. In 
particular, the non-empty statement on end cannot merely name 
a label. 

If start is a label in the program, program execution will start 
there. If not, execution begins with the first executable state¬ 
ment; define is not an executable statement. 

There are no builtin functions. 

Parentheses for arithmetic are not needed. Normal precedence 
applies. Because of this, the arithmetic operators / and • must be 
set off by spaces. 

The right side of assignments must be non-empty. 

Either * or " may be used for literal quotes. 

The pseudo-variable sysppt is not available. 

SEE ALSO 

awk(l). 

’’SNOBOL, a String Manipulation Language,” by D. J. Farber, R. E. Griswold, 
and 1. P. Polonsky, JACM 11 (1964), pp. 21-30. 
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NAME 

soelim - eliminate .so's from nrofi input 

SYNOPSIS 

soelim [ file ... ] 

DESCRIPTION 

Soelim reads the specified files or the standard input and performs the 
textual inclusion implied by the nroff directives of the form 

.so somefile 

when they appear at the beginning of input lines. This is useful since 
programs such as tbl do not normally do this; it allows the placement of 
individual tables in separate files to be run as a part of a large document. 

An argument consisting of a single minus (—) is taken to be a file name 
corresponding to the standard input. 

Note that inclusion can be suppressed by using *" instead of V, i.e. 

'so /usr/lib/tmac.s 
A sample usage of soelim would be 

soelim exum?.n | tbl | nrofi —ms | col | lpr 

SEE ALSO 

colcrt(l). more(l) 

AUTHOR 

William Joy 

BUGS 

The format of the source commands must involve no strangeness — 
exactly one blank must precede and no blanks follow the file name. 


Page 1 


February 17. 1984 








SORT(l) 


liUNIX 


SORT(1) 


NAME 

sort — sort or merge files 
SYNOPSIS 

sort [ — mubdfinrtx ] [ +joosi [ —pos2 ] ] ... [ —o name ] [ —T direc¬ 
tory ] [ name ] ... 

DESCRIPTION 

Sort sorts lines of all the named files together and writes the result on 
the standard output. The name ’ means the standard input. If no 
input files are named, the standard input is sorted. 

The default sort key is an entire line. Default ordering is lexicographic 
by bytes in machine collating sequence. The ordering is affected globally 
by the following options, one or more of which may appear. 

b Ignore leading blanks (spaces and tabs) in field comparisons. 

d 'Dictionary' order: only letters, digits and blanks are significant in 
comparisons. 

f Fold upper case letters onto lower case. 

i Ignore characters outside the ASCII range 040-0176 in nonnumeric 
comparisons. 

n An initial numeric string, consisting of optional blanks, optional 
minus sign, and zero or more digits with optional decimal point, is 
sorted by arithmetic value. Option n implies option b. 

r Reverse the sense of comparisons. 

tx 'Tab character’ separating fields is x. 

The notation +posl —pos2 restricts a sort key to a field beginning atposi 
and ending just before pos2. Posl and pos2 each have the form m.n, 
optionally followed by one or more of the flags bdfinr, where m tells a 
number of fields to skip from the beginning of the line and n tells a 
number of characters to skip further. If any flags are present they over¬ 
ride all the global ordering options for this key. If the b option is in 
effect n is counted from the first nonblank in the field; b is attached 
independently to pos2. A missing .n means .0; a missing —pos2 means the 
end of the line. Under the —tx option, fields are strings separated by x; 
otherwise fields are nonempty nonblank strings separated by blanks. 

When there are multiple sort keys, later keys are compared only after all 
earlier keys compare equal. Lines that otherwise compare equal are 
ordered with all bytes significant. 

These option arguments are also understood: 

c Check that the input file is sorted according to the ordering rules; 
give no output unless the file is out of sort. 

m . Merge only, the input files are already sorted. 

o The next argument is the name of an output file to use instead of 
the standard output. This file may be the same as one of the inputs. 

T The next argument is the name of a directory in which temporary 
files should be made. 
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u Suppress all but one in each set of equal lines. Ignored bytes and 
bytes outside keys do not participate in this comparison. 

Examples. Print in alphabetical order all the unique spellings in a list of 
words. Capitalized words differ from uncapitalized, 
sort —u +0f +0 list 


Print the password file (passwd(5 )) sorted by user id number (the 3rd 
colon-separated field). 

sort -t: +2n /etc/passwd 


Print the first instance of each month in an already sorted file of (month 
day) entries. The options -um with just one input file make the choice of 
a unique representative from a set of equal lines predictable. 


sort —um +0 —1 dates 


FILES 


/usr 


/tmp/stm*. /tmp/*: first and second tries for temporary files 


SEE ALSO % 

uniq(l). comm(l), rev(l), join(l) 

D1AGN °Comments and exits with nonzero status for various trouble conditions 
and for disorder discovered under option -c. 


BUGS 


Very long lines are silently truncated. 
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NAME 

spell, spellin. spellout - find spelling errors 
SYNOPSIS 

spell [ option ] ... [ file ] ... 

/usr/dict/spellin [ list ] 

/usr/dict/speUout [ -d ] list 
DESCRIPTION 

Spell collects words from the named documents, and looks them up in a 
spelling list. Words that neither occur among nor are derivable (by 
applying certain inflections, prefixes or suffixes) from words in the spel¬ 
ling list are printed on the standard output. If no files are named words 
are collected from the standard input. 

Spell ignores most troff, tbl and egn(l) constructions. 

Lnder the —▼ option, all words not literally in the spelling list are printed 
and plausible derivations from spelling list words are indicated. 

Lnder the —b option, British spelling is checked. Besides preferring cen¬ 
tre. colour, speciality, travelled, etc., this option insists upon -ise in 
words like standardise. Fowler and the OED to the contrary notwith¬ 
standing. 

Under the -x option, every plausible stem is printed with ’=’ for each 
word. 

The spelling list is based on many sources, and while more haphazard 
than an ordinary dictionary, is also more effective in respect to proper 
names and popular technical words. Coverage of the specialized vocabu¬ 
laries of biology, medicine and chemistry is light. 

Pertinent auxiliary files may be specified by name arguments, indicated 
below with their default settings. Copies of all output are accumulated in 
the history file. The stop list filters out misspellings (e.g. 
thier=thy—y+ier) that would otherwise pass. 

Two routines help maintain the hash lists used by spell. Both expect a list 
of words, one per line, from the standard input. Spellin adds the words 
on the standard input to the preexisting list and places a new lisu on the 
standard output. If no list is specified, the new list is created from 
scratch. Spellout looks up each word in the standard input and prints on 
the standard output those that are missing from (or present on, with 
option —d) the hash list. 

FILES 

/usr/dict/hlist[ab): hashed spelling lists, American Sc British 
S = /usr/dict/hstop: hashed stop list 
H=/usr/dict/spellhist: history file 
/usr/lib/spell 

deroff(l), sort(l), tee(l). sed(l) 

BUGS 

The spelling list’s coverage is uneven; new installations will probably wish 
to monitor the output for several months to gather local additions. 

British spelling was done by an American. 
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NAME 

spline — interpolate smooth curve 

SYNOPSIS 

spline [ options ] 

DESCRIPTION 

Spline takes pairs of numbers from the standard input as abscissas and 
ordinates of a function. It produces a similar set, which is approximately 
equally spaced and includes the input set. on the standard output. The 
cubic spline output (R. W. Hamming, Numerical Methods for Scientists 
and Engineers , 2nd ed., pp. 349fT) has two continuous derivatives, and 
sufficiently many points to look smooth when plotted, for example by 
graph(lG). 

The following options are recognized, each as a separate argument: 

—a Supply abscissas automatically (they are missing from the input); 
spacing is given by the next argument, or is assumed to be 1 if next 
argument is not a number. 

—k The constant k used in the boundary value computation: 

yo=*vr. 

is set by the next argument (default k = 0). 

—n Space output points so that approximately n intervals occur 
between the lower and upper x limits (default n = 100). 

—p Make output periodic, i.e., match derivatives at ends. First and last 
input values should normally agree. 

—x Next 1 (or 2) arguments are lower (and upper) * limits. Normally, 
these limits are calculated from the data. Automatic abscissas 
start at lower limit (default 0). 

SEE ALSO 

graph(lG). 

DIAGNOSTICS 

When data is not strictly monotone in x, spline reproduces the input 
without interpolating extra points. 

BUGS 

A limit-of 1,000 input points is enforced silently. 
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NAMfc 

split - split a file into pieces 
SYNOPSIS 

split [ —n ] [ file [ name ] ] 
DESCRIPTION 


Split reads file and writes it in n-line pieces (default 1000) as manv 
namfwuh ° nt0 * ”1 °i out P ut fll « The name of the first output fife's 
“fiTve" x is“e“faSu ’ ° “ ° n ‘'’'‘“firaphically. « output name 


If no input file is 
input file is used. 


given, or if - is given in its stead, then the standard 
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NAME 

stctrl.stskip - special streamer features, skip files 
SYNOPSIS 

stctri [-e] [-r] *' 
stskip count 


DESCRIPTION 

• Stctri is used to execute special streamer 
options are: 


commands. 


The possible 


-e to erase the whole tape. 

—r to make a retension of the tape. 

fe%ped PS the neXt fi " S ° n the U P= Count holds the number of files to 
These two commands always refer to streamer drive 0 

FILES 

/dev/rstO 
/dev/nrstO 
SEE ALSO 
st(4) 
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NAHE 

stksiz - set stacksize 

SYNOPSIS 

stksiz size file ... 

DESCRIPTION 

Stksiz sets the stacksize of the executable program file to size bytes. 

A default size of 2k bytes is set by the linker. For larger or recursive 
programs you will have to increase this amount. See in the EXAMPLE sec¬ 
tion of adb(l) how to recognize a stack overflow. 

The stksiz command is necessary because an automatic expansion of the 
stack in case of a stack overflow is in general impossible with the MC 
68000, as it knows no bus-error-recovery. The system can recover from a 
stack overflow and increase the stack size automatically, if the executed 
code was e g. "move.l xxx,-2042(a6)'\ or even "move.w xxx,-(a7)". but not 
from "move.l xxx.-(a7)”, as there is no way of finding out whether the 
error occurred on the first or second halfword. 

With the MC 68010 this command is obsolete. 

SEE ALSO 

size(l) 
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NAME 

strings - find the printable strings in a object, or other binary, file 
SYNOPSIS 

strings [ — ] [ —o ] [ -number ] file ... 

DESCRIPTION 

Strings looks for ascii strings in a binary file. A string is any sequence of 
4 or more printing characters ending with a newline or a null. Unless the 
— flag is given, strings only looks in the initialized data space of object 
files. If the —o flag is given, then each string is preceded by its offset in 
the file (in octal). If the -number flag is given then number is used as 
the minimum string length rather than 4. 

Strings is useful for identifying random object files and many other 
things. 

SEE ALSO 

od(l) 

BUGS 

The algorithm for identifying strings is extremely primitive 
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NAME 

strip - remove symbols and relocation bits 
SYNOPSIS 


strip name ... 

DESCRIPTION 

SSSasaas 

The effect of strip is the same as use of the -s option of Id 

Sr — ” 


FILES 

/tmp/stm* temporary file 
SEE ALSO 

ld(l). 
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NAME 

struct - structure Fortran programs 
SYNOPSIS 

struct [ option ] ... file 
DESCRIPTION 

Struct translates the Fortran program specified by file (standard input 
default) into a Ratfor program. Wherever possible. Ratfor control con¬ 
structs replace the original Fortran. Statement numbers appear only 
where still necessary. Cosmetic changes are made, including changing 
Hollerith strings into quoted strings and relational operators into sym¬ 
bols (.e.g. \GT.’ into ’>’). The output is appropriately indented. 

The following options may occur in any order. 

—s Input is accepted in standard format, i.e. comments are specified 

by a c. C, or • in column 1, and continuation lines are specified by 
a nonzero, nonblank character in column 6. Normally, a state¬ 
ment whose first nonblank character is not alphanumeric is 
treated as a continuation. 

—i Do not turn computed goto statements into switches. (Ratfor does 

not turn switches back into computed goto statements.) 

—a Turn sequences of else ifs into a non-Ratfor switch of the form 
switch { 

case predl: code 
case pred2: code 
case pred3: code 
default: code 

I 

The case predicates are tested in order; the code appropriate to 
only one case is executed. This generalized form of switch state¬ 
ment does not occur in Ratfor. 

—b Generate goto's instead of multilevel break statements. 

—n Generate goto’s instead of multilevel next statements. 

—en If n is 0 (default), place code within a loop only if it can lead to an 
iteration of the loop. If n is nonzero, admit code segments with 
fewer than n statements to a loop if otherwise the loop would have 
exits to several places including the segment, and the segment can 
be reached only from the loop. 

FILES 

/tmp/struct* 

/usr/lib/struct/* 

SEE ALSO 

f77(l) 

BUGS 

Struct knows Fortran 66 syntax, but not full Fortran 77 (alternate 
returns. IF...THEN...ELSE, etc.) 

If an input Fortran program contains identifiers which are reserved 


Page 1 


February 17.1984 



STRUCK 1) 


liUNIX 


STRUCK 1) 


/ 


words in Ratfor, the structured version of the program will not be a valid 
Ratfor program. 

Extended range DO’s generate cryptic errors. 

Columns 73-80 are not special even when —s is in effect. 

Will not generate Ratfor FOR statements. 
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NAME 


stty - set the options for a terminal 


SYNOPSIS 

stty [ —a ] [ —g ] [ options ] 

DESCRIPTION 

Stty sets certain terminal I/O options for the device that is the current 
standard input; without arguments, it reports the settings of certain 
options; with the —a option, it reports all of the option settings; with the 
—g option, it reports current settings in a form that can be used as an 
argument to another sffy command. Detailed information about the 
modes listed in the first five groups below may be found in fermio(4). 
Options in the last group are implemented using options in the previous 
groups. Note that many combinations of options make no sense, but no 
sanity checking is performed. The options are selected from the follow¬ 
ing: 

Control Modes 

parenb (-parenb) enable (disable) parity generation and detection. 

parodd (-parodd) select odd (even) parity. 

cs5 cs6 cs7 cs0 select character size (see fermio(4)). 

0 hang up phone line immediately. 

50 75 110 134 150 200 300 600 1200 1600 2400 4800 9600 exta extb 

Set terminal baud rate to the number given, if possi¬ 
ble. (All speeds are not supported by all hardware 
interfaces.) 

hang up (do not hang up) a DATA-PHONE* data set con¬ 
nection on last close, 
same as hupcl (—hupcl). 
use two (one) stop bits per character, 
enable (disable) the receiver, 
assume a line without (with) modem control. 


hupcl (—hupcl) 


hup (—hup) 
cstopb (—cstopb) 
cread (—cread) 
clocal (—clocal) 

Input Modes 

ignbrk (-ignbrk) ignore (do not ignore) break on input, 
brkint (-brkint) signal (do not signal) INTR on break, 
ignpar (-ignpar) ignore (do not ignore) parity errors, 
parmrk (—parmrk) 

mark (do not mark) parity errors (see fermio(4)). 
enable (disable) input parity checking, 
strip (do not strip) input characters to seven bits, 
map (do not map) NL to CR on input, 
ignore (do not ignore) CR on input, 
map (do not map) CR to NL on input, 
map (do not map) upper-case alphabetics to lower 
case on input. 

enable (disable) START/STOP output control. Output is 
stopped by sending an ASCII DC3 and started by send¬ 
ing an ASCII DC1. 

allow any character (only DCl) to restart output, 
request that the system send (not send) START/STOP 
characters when the input queue is nearly empty/full. 


inpck (—inpck) 
istrip (—istrip) 
inlcr (—inlcr) 
igncr (—igncr) 
icml (—icml) 
iuclc (—iuclc) 

ixon (—ixon) 


ixany (—ixany) 
ixoff (—ixoff) 


Output Modes 
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oposi (—opost) 

olcuc (—olcuc) 

onlcr (—onlcr) 
ocmi (—ocml) 
onocr (—onocr) 
onlret (—onlret) 


post-process output (do not post-process output; 
ignore all other output modes). 

map (do not map) lower-case alphabetics to upper 
case on output. 

map (do not map) NL to CR-NL on output. 

map (do not map) CR to NL on output. 

do not (do) output CRs at column zero. 

on the terminal NL performs (does not perform) the CR 


ofill (—ofill) 
of del (—ofdel) 
crO crl cr2 cr3 

nlO nil 
tabO tabl tab2 tab3 


function. 

use fill characters (use timing) for delays, 
fill characters are DELs (NULs). 

select style of delay for carriage returns (see ter- 
mio( 4)). 

select style of delay for line-feeds (see fermto(4)). 


bsO bsl 
ffO ffl 
vtO vtl 


select style of delay for horizontal tabs (see ter- 
mio(4)). 

select style of delay for backspaces (see fermio(4)). 
select style of delay for form-feeds (see fermio(4)). 
select style of delay for vertical tabs (see fermto(4)). 


Local Modes 
isig (—isig) 

icanon (— icanon) 

xcase (—xcase) 

echo (—echo) 
echoe (—echoe) 


echok (—echok) 
lfkc (—lfkc) 
echonl (—echonl) 
noflsh (—noflsh) 
stwrap (—stwrap) 

stflush (—stflush) 

stappl (—stappl) 


enable (disable) the checking of characters against 
the special control characters INTR and QUIT, 
enable (disable) canonical input (ERASE and KILL pro¬ 
cessing). 

canonical (unprocessed) upper/lower-case presenta¬ 
tion. 

echo back (do not echo back) every character typed, 
echo (do not echo) ERASE character as a backspace- 
space-backspace string. Note: this mode will erase the 
ERASEed character on many CRT terminals; however, it 
does not keep track of column position and, as a 
result, may be confusing on escaped characters, tabs, 
and backspaces. 

echo (do not echo) NL after KILL character. 

the same as echok (—echok); obsolete. 

echo (do not echo) NL. 

disable (enable) flush after INTR or QUIT. 

disable (enable) truncation of lines longer than 79 

characters on a synchronous line. 

enable (disable) flush on a synchronous line after 
every write (2). 

use application mode (use line mode) on a synchro¬ 
nous line. 


Control Assignments 
control-character c 

set control-character to c, where control-character is 
erase, kill, intr, quit, eof. eol. min, or time (min and 
time are used with —icanon; see fermio(4)). If c is pre¬ 
ceded by an (escaped from the shell) caret (~), then 
the value used is the corresponding CTRL character 
(e g., "~d” is a CTRL-d); is interpreted as DEL and 
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" is interpreted as undefined, 
line t set line discipline to i (0 < i < 127 ). 

Combination Modes 

evenp or parity enable parenb and cs7. 
oddp enable parenb. cs7, and parodd. 

—parity, —evenp. or —oddp 

disable parenb, and set cs8. 
raw (—raw or cooked) 

enable (disable) raw input and output (no ERASE. KILL, 
INTR, QUIT, EOT. or output post processing), 
nl (— nl) unset (set) icml, onlcr. In addition — nl unsets inlcr, 

igncr, ocml, and onlret 

lease (-lease) set (unset) xcase, iuclc, and olcuc. 

LCASE (—LCASE) same as lease (—lease), 

tabs (—tabs or tab3) 

preserve (expand to spaces) tabs when printing, 
ek reset ERASE and KILL characters back to normal BS 

and CTRL-X. 

sane resets all modes to some reasonable values. 

term set all modes suitable for the terminal type term, 

where ferm is one of Lty33, tty37, vt05, tn300, U700. or 
tek. 

SEE ALSO 

tabs(l). ioctl(2), termio(4) 
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NAME 

style — analyze surface characteristics of a document 
SYNOPSIS 

style [ -ml ] [ -mm ] [ -a ] [ -e ] [ -1 num ] [ -r num ] [ —p ] [ —P 
] file ... 

DESCRIPTION 

Style analyzes the surface characteristics of the writing style of a docu¬ 
ment. It reports on readability, sentence length and structure, word 
length and usage, verb type, and sentence openers. Because style runs 
deroff before looking at the text, formatting header files should be 
included as part of the input. The default macro package —ms may be 
overridden with the flag —mm. The flag —ml, which causes derofT to skip 
lists, should be used if the document contains many lists of non¬ 
sentences. The other options are used to locate sentences with certain 
characteristics. 

—a print all sentences with their length and readability index. 

—e print all sentences that begin with an expletive. 

—p print all sentences that contain a passive verb. 

-lnum 

print all sentences longer than num. 

—mum 

print all sentences whose readability index is greater than num. 

—P print parts of speech of the words in the document. 

SEE ALSO 

deroff(l). diction(l) 

BUGS 

Use of non-standard formatting macros may cause incorrect sentence 
breaks. 
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NAME 

su — become super-user or another user 
SYNOPSIS 

su [ - ] [ name [ arg ... ] ] 

DESCRIPTION 

Su allows one to become another user without logging off. The default 
user name is root (i.e., super-user). 

To use su, the appropriate password must be supplied (unless one is 
already super-user). If the password is correct, su will execute a new 
shell with the user ID set to that of the specified user. To restore normal 
user ID privileges, type an EOF to the new shell. 

Any additional arguments are passed to the shell, permitting the super- 
user to run shell procedures with restricted privileges (an arg of the 
form —c string executes string via the shell). When additional arguments 
are passed, /bin/sh is always used. When no additional arguments are 
passed, su uses the shell specified in the password file. 

An initial — flag causes the environment to be changed to the one that 
would be expected if the user actually logged in again. This is done by 
invoking the shell with an argO of —su causing the .profile in the home 
directory of the new user ID to be executed. Note that the .profile can 
check argO for —sh or —su to determine how it was invoked. 

EXAMPLES 

su 

su - adm -c "/usr/lib/acct/ckpacct” 

FILES 

/etc/passwd system’s password file 
SHOME/.profile user’s profile 
SEE ALSO 

env(l), login(l), sh(l). environ(7). 
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NAME 

sum — sum and count blocks in a file 

SYNOPSIS 

sum file 

DESCRIPTION 

Sum calculates and prints a 16-bit checksum for the named file, and also 
prints the number of blocks in the file. It is typically used to look for bad 
spots, or to validate a file communicated over some transmission line. 

SEE ALSO 

wc(l) 

DIAGNOSTICS 

‘Read error’ is indistinuishable from end of file on most devices; check 
the block count. 


Page 1 


February 17. 1984 








TABS(l) 


MUNIX 


TABS(1) 


NAME 


tabs - set tabs on a terminal 


SYNOPSIS 

tabs [ tabspec ] [ +mn ] [ —Ttype ] 

DESCRIPTION 

Tabs sets the tab stops on the user's terminal according to the tab 
specification tabspec, after clearing any previous settings. The user 
must of course be logged in on a terminal with remotely-settable 
hardware tabs. 

Users of GE TermiNet terminals should be aware that they behave in a 
different way than most other terminals for some tab settings: the first 
number in a list of tab settings becomes the left margin on a TermiNet 
terminal. Thus, any list of tab numbers whose first element is other than 
1 causes a margin to be left on a TermiNet, but not on other terminals. A 
tab list beginning with 1 causes the same effect regardless of terminal 
type. It is possible to set a left margin on some other terminals, although 
in a different way (see below). 

Four types of tab specification are accepted for tabspec: “canned,” 
repetitive, arbitrary, and file. If no tabspec is given, the default value is 
—8, i.e., UNIX System “standard” tabs. The lowest column number is 1. 
Note that for tabs, column 1 always refers to the leftmost column on a 
terminal, even one whose column markers begin at 0, e.g., the DASI 300, 
DASI 300s, and DASI 450. 

—code Gives the name of one of a set of “canned” tabs. The legal codes 
and their meanings are as follows: 

-a 1,10,16,36,72 

Assembler, IBM S/370, first format 
—a2 1,10,16.40,72 

Assembler, IBM S/370, second format 
-c 1,8,12,16,20,55 

COBOL, normal format 
—c2 1,6,10,14,49 

COBOL compact format (columns 1-6 omitted). Using this code, 
the first typed character corresponds to card column 7, one 
space gets you to column 8, and a tab reaches column 12. Files 
using this tab setup should include a format specification as fol¬ 
lows: 

<:t—c2 m6 s66 d:> 

—c3 1,6,10,14.18.22,26,30,34.38.42,46,50,54,58.62,67 

COBOL compact format (columns 1-6 omitted), with more tabs 
than —c2. This is the recommended format for COBOL. The 
appropriate format specification is: 

<:t—c3 m6 s66 d:> 

-f 1,7,11.15.19.23 

FORTRAN 

-p 1.5.9,13.17,21.25,29.33.37.41.45.49.53.57.61 

PL/I 

-s 1,10,55 

SN0B0L 
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-u 1.12.20.44 

UNIVAC 1100 Assembler 


In addition to these "canned" formats, three other types exist: 


—n A repetitive specification requests tabs at columns 1+n, l+2*n, 

etc. Note that such a setting leaves a left margin of n columns on 
TermiNet terminals only. Of particular importance is the value 
—8: this represents the UNIX System "standard" tab setting, and is 
the most likely tab setting to be found at a terminal. It is 
required for use with the nroff —h option for high-speed output. 
Another special case is the value —0, implying no tabs at all. 
nl ,n2,... 

The arbitrary format permits the user to type any chosen set of 
numbers, separated by commas, in ascending order. Up to 40 
numbers are allowed. If any number (except the first one) is pre¬ 
ceded by a plus sign, it is taken as an increment to be added to 
the previous value. Thus, the tab lists 1,10,20,30 and 
1,10,+ 10,+10 are considered identical. 

—file If the name of a file is given, tabs reads the first line of the file, 
searching for a format specification. If it finds one there, it sets 
the tab stops according to it, otherwise it sets them as —8. This 
type of specification may be used to make sure that a tabbed file 
is printed with correct tab settings, and would be used with the 
pr(l) command: 

tabs — file; pr file 

Any of the following may be used also; if a given flag occurs more than 
once, the last value given takes effect: 


—Hype 

Tabs usually needs to know the type of terminal in order to set 
tabs and always needs to know the type to set margins. Type is a 
name listed in ferm(5). If no -T flag is supplied, tabs searches for 
the ITERM value in the environment (see envtron(5)). If no type 
can be found, fobs tries a sequence that will work for many termi¬ 
nals. 

+mn The margin argument may be used for some terminals. It causes 
all tabs to be moved over n columns by making column n+i the 
left margin. If +m is given without a value of n, the value 
assumed is 10. For a TermiNet, the first value in the tab list 
should be 1, or the margin will move even further to the right. 
The normal (leftmost) margin on most terminals is obtained by 
+m0. The margin for most terminals is reset only when the +m 
flag is given explicitly. 


Tab and margin setting is performed via the standard output. 


DIAGNOSTICS 

illegal tabs 
illegal increment 

unknown tab code 
can t open 


when arbitrary tabs are ordered incorrectly. 

when a zero or missing increment is found in an 

arbitrary specification. 

when a "canned" code cannot be found. 

if — file option used, and file can’t be opened. 
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file indirection if —file option used and the specification in that file 

points to yet another file. Indirection of this form is 
not permitted. 

SEE ALSO 

nroff(l), environ(7), term(7). 

BUGS 

There is no consistency among different terminals regarding ways of 
clearing tabs and setting the left margin. 

It is generally impossible to usefully change the left margin without also 
setting tabs. 

Tabs clears only 20 tabs (on terminals requiring a long sequence), but is 
willing to set 40. 
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NAME 

tail - deliver the last part of a file 
SYNOPSIS 

tail [ ±number[lbc] ] [ file ] 


DESCRIPTION . . 

Tail copies the named file to the standard output beginning at a desig¬ 
nated place. If no file is named, the standard input is used. 

Copying begins at distance +number from the beginning, or -number 
from the end of the input. Number is counted in units of lines, blocks or 
characters, according to the appended option 1» b or c. When no units are 
specified, counting is by lines. 


SEE ALSO 

dd(l) 

BUGS 

Tails relative to the end of the file are treasured up in a buffer, and thus 
are limited in length. Various kinds of anomalous behavior may happen 
with character special files. 
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NAME 

tar — tape archiver 
SYNOPSIS 

tar [ key ] [ name ... ] 

DESCRIPTION 

Tar saves and restores files on magtape. Its actions are controlled by the 
key argument. The key is a string of characters containing at most one 
function letter and possibly one or more function modifiers. Other argu¬ 
ments to the command are file or directory names specifying which files 
are to be dumped or restored. In all cases, appearance of a directory 
name refers to the files and (recursively) subdirectories of that direc¬ 
tory. 

The function portion of the key is specified by one of the following 
letters: 

r The named files are written on the end of the tape. The c func¬ 
tion implies this. 

x The named files are extracted from the tape. If the named file 
matches a directory whose contents had been written onto the 
tape, this directory is (recursively) extracted. The owner, 
modification time, and mode are restored (if possible). If no file 
argument is given, the entire content of the tape is extracted. 
Note that if multiple entries specifying the same file are on the 
tape, the last one overwrites all earlier. 

t The names of the specified files are listed each time they occur on 

the tape. If no file argument is given, all of the names on the tape 
are listed. 

u The named files are added to the tape if either they are not 
already there or have been modified since last put on the tape. 

c Create a new tape; writing begins on the beginning of the tape 

instead of after the last file. This command implies r. 

The following characters may be used in addition to the letter which 
selects the function desired. 

0.7 This modifier selects the drive on which the tape is mounted. 

The default is 1. 

v Normally for does its work silently. The ▼ (verbose) option 

causes it to type the name of each file it treats preceded by the 
function letter. With the t function, ▼ gives more information 
about the tape entries than just the name. 

w causes for to print the action to be taken followed by file name, 

then wait for user confirmation. If a word beginning with *y’ is 
given, the action is performed. Any other input means don’t do 
it. 

f causes for to use the next argument as the name of the archive 

instead of /dev/mt?. If the name of the file is tar writes to 
standard output or reads from standard input, whichever is 
appropriate. Thus, for can be used as the head or tail of a filter 
chain Tar can also be used to move hierarchies with the 
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command 

cd fromdir; tar cf - . | (cd todir; tar xf -) 

b causes tar to use the next argument as the blocking factor for 

tape records. The default is 1, the maximum is 127. This option 
should only be used with raw magnetic tape archives (See f 
above). The block size is determined automatically when read¬ 
ing tapes (key letters ‘x’ and't'). 

1 tells tar to complain if it cannot resolve all of the links to the 

files dumped. If this is not specified, no error messages are 
printed. 

m tells far to not restore the modification times. The mod time 

will be the time of extraction. 

FILES 

/dev/mt? 

/dev/rmt? 

/tmp/tar* 

DIAGNOSTICS 

Complaints about bad key characters and tape read/write errors. 

Complaints if enough memory is not available to hold the link tables. 

BUGS 

There is no way to ask for the n-th occurrence of a file. 

Tape errors are handled ungracefully. 

The u option can be slow. 

The b option should not be used with archives that are going to be 

updated If the archive is on a disk file the b option should not be used 

at all, as updating an archive stored in this manner can destroy it. 

The current limit on file name length is 100 characters. 
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NAME 

tbl — format tables for nrofT or troff 
SYNOPSIS 

tbl [ -TX ] [ files ] 

DESCRIPTION 

Tbl is a preprocessor that formats tables for nro ff{l) or troff (1). The 
input files are copied to the standard output, except for lines between .TS 
and .TE command lines, which are assumed to describe tables and are 
re-formatted by tbl. (The .TS and .TE command lines are not altered by 
tbl). 

.TS is followed by global options. The available global options are: 

center center the table (default is left-adjust); 
expand make the table as wide as the current line length; 
box enclose the table in a box; 
doublebox 

enclose the table in a double box; 
allbox enclose each item of the table in a box; 
tab (x) use the character x instead of a tab to separate items in 
a line of input data. 

The global options, if any, are terminated with a semi-colon (;). 

Next come lines describing the format of each line of the table. Each 
such format line describes one line of the actual table, except that the 
last format line (which must end with a period) describes all remaining 
lines of the table. Each column of each line of the table is described by a 
single key-letter, optionally followed by specifiers that determine the 
font and point size of the corresponding item, that indicate where verti¬ 
cal bars are to appear between columns, that determine column width, 
inter-column spacing, etc. The available key-letters are: 

c center item within the column; 
r right-adjust item within the column; 

1 left-adjust item within the column; 

n numerically adjust item in the column: units positions of 
numbers are aligned vertically; 
s span previous item on the left into this column; 
a center longest line in this column and then left-adjust all 
other lines in this column with respect to that centered 
line; 

^ span down previous entry in this column; 

_ replace this entry with a horizontal line; 

= replace this entry with a double horizontal line. 

The characters B and I stand for the bold and italic fonts, respectively; 
the character | indicates a vertical line between columns. 

The format lines are followed by lines containing the actual data for the 
table, followed finally by .TE. Within such data lines, data items are nor¬ 
mally separated by tab characters. 

If a data line consists of only _ or =. a single or double line, respectively, 
is drawn across the table at that point; if a single item in a data line con¬ 
sists of only _ or =, then that item is replaced by a single or double line. 
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Full details of all these and other features of tbl are given in the refer¬ 
ence manual cited below. 

The —TX option forces tbl to use only full vertical line motions, making 
the output more suitable for devices that cannot generate partial verti¬ 
cal line motions (e.g., line printers). 

If no file names are given as arguments, tbl reads the standard input, so 
it may be used as a filter. When it is used with egn(l) or negn(l), tbl 
should come first to minimize the volume of data passed through pipes. 

EXAMPLE 

If we let -* represent a tab (which should be typed as a genuine tab), then 
the input: 

.TS 

center box ; 
cB s s 
cl | cl s 
^ | c c 
1 | n n . 

Household Population 

Town-*Households 

-»Number-*Size 

Bedminster-*789-*3.26 
Bernards Twp.-»3087-*3.74 
Bernardsville-*20l8-*3.30 
Bound Brook-*3425-»3.04 
Bridgewater-*7897-*3.8l 
Far Hills-*240-*3.19 
.TE 

yields: 


Household Population 

Town 


Households 
Number Size 

Bedminster 
Bernards Twp. 
Bernardsville 
Bound Brook 
Bridgewater 

Far Hills 

789 3.26 

3087 3.74 

2018 3.30 

3425 3.04 

7897 3.81 

240 3.19 


SEE ALSO 

TBL — A Program to Format Tables by M. E. Lesk 
eqn(l), mm(l), mmt(l), trofT(l), mm(7). mv(7). 

BUGS 

See BUGS under troff{\). 
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NAfciE 

tc — phototypesetter simulator 
SYNOPSIS 

tc [ -t ] [ -sn ] [ -pi ] [ file ] 

DESCRIPTION 

Tc interprets its input (standard input default) as device codes for a 
Wang Laboratories, Inc. C/A/T phototypesetter. The standard output of 
tc is intended for a Tektronix 4014 terminal with ASCII and APL character 
sets. The sixteen typesetter sizes are mapped into the 4014’s four sizes; 
the entire TROFF character set is drawn using the 4014's character gen¬ 
erator. with overstruck combinations where necessary. Typical usage is: 

trofT -t files | tc 

At the end of each page, tc waits for a new-line (empty line) from the 
keyboard before continuing on to the next page. In this wait state, the 
command e will suppress the screen erase before the next page; sn will 
cause the next n pages to be skipped; and !cmd will send cmd to the 
shell. 

The command line options are: 

—t Don’t wait between pages (for directing output into a file). 

—sn Skip the first n pages. 

—pi Set page length to l; l may include the scale factors p (points), i 
(inches), c (centimeters), and P (picas); default is picas. 

SEE ALSO 

4014(1), sh(l), tplot(lG), troff(l). 

BUGS 

Font distinctions are lost. 
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NAftE 

tee — pipe fitting 
SYNOPSIS 

tee [ -i ] [ -a ] [ file ] ... 

DESCRIPTION 

Tee transcribes the standard input to the standard output and makes 
copies in the files. Option —i ignores interrupts; option —a causes the out¬ 
put to be appended to the files rather than overwriting them. 
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NA1IE 

test - condition evaluation command 

SYNOPSIS 

test expr 
[ expr ] 

DESCRIPTION 

Test evaluates the expression expr and. if its value is true, returns a zero 
(true) exit status; otherwise, a non-zero (false) exit status is returned; 
test also returns a non-zero exit status if there are no arguments. The 
following primitives are used to construct expr: 

—r file true if file exists and is readable. 

—w file true if file exists and is writable. 

—x file true if file exists and is executable. 

—f file true if file exists and is a regular file. 

—d file true if file exists and is a directory. 

-c file true if file exists and is a character special file. 

—b file true if file exists and is a block special file. 

—p file true if file exists and is a named pipe (fifo). 

—u file true if file exists and its set-user-ID bit is set. 

—g file true if file exists and its set-group-ID bit is set. 

—k file true if file exists and its sticky bit is set. 

—s file true if file exists and has a size greater than zero. 

—t ( fildes ] T 

true if the open file whose file descriptor number is fildes (1 
by default) is associated with a terminal device. 

—z si true if the length of string si is zero. 

—n si true if the length of the string si is non-zero. 

si = s2 true if strings si and s2 are identical. 

si != s2 true if strings si and s2 are not identical. 

si true if sJ is nof the null string. 

nl —eqn2 true if the integers nl and n2 are algebraically equal. Any of 
the comparisons —ne, —gt, —ge. —It, and —!e may be used in 
place of — eq. 

These primaries may be combined with the following operators: 

! unary negation operator. 

—a binary and operator. 

—o binary or operator (—a has higher precedence than —o). 

( expr ) parentheses for grouping. 

Notice that all the operators and flags are separate arguments to test. 
Notice also that parentheses are meaningful to the shell and, therefore, 
must be escaped. 
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SEE ALSO 

find(l). sh(l). 

WARNING 

In the second form of the command (i.e., the one that uses [], rather 
than the word test ). the square brackets must be delimited by blanks. 
Some UNIX systems do not recognize the second form of the command. 
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NAME 

time — time a command 

SYNOPSIS 

time command 

DESCRIPTION 

The given command is executed; after it is complete, time prints the 
elapsed time during the command, the time spent in the system, and the 
time spent in execution of the command. Times are reported in seconds. 

The times are printed on the diagnostic output stream. 

BUGS 

Elapsed time is accurate to the second, while the CPU times are meas¬ 
ured to the 50th or 60th second, dependent on the line frequency and 
the definition of HZ in /usr/sys/conf.h. Thus the sum of the CPU times 
can be up to a second larger than the elapsed time. 
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timex — time a command; report process data and system activity 
SYNOPSIS 

timex [ options ] command 
DESCRIPTION 

The given command is executed; the elapsed time, user time and system 
time spent in execution are reported in seconds. Optionally, process 
accounting data for the command and all its children can be listed or 
summarized, and total system activity during the execution interval can 
be reported. 

The output of fimez is written on standard error. 

Options are: 

—p List process accounting records for command and all its children. 
Suboptions f, h, k, m. r. and t modify the data items reported, as 
defined in accfcom(l). The number of blocks read or written and the 
number of characters transferred are always reported. 

—o Report the total number of blocks read or written and total charac¬ 
ters transferred by command and all its children. 

—s Report total system activity (not just that due to command) that 
occurred during the execution interval of command. All the data 
items listed in sar(l) are reported. 

SEE ALSO 

acctcom(l), sar(l). 

WARNING , . , 

Process records associated with command are selected from the 
accounting file /usr/adm/pacct by inference, since process genealogy is 
not available. Background processes having the same user-id, terminal- 
id. and execution time window will be spuriously included. 

EXAMPLES 

A simple example: 

timex —ops sleep 60 

A terminal session of arbitrary complexity can be measured by timing a 
sub-shell: 

timex — opskmt sh 

session commands 

EOT 


Page 1 


February 17, 1984 





TK( 1) 


liUNIX 


TK( 1) 


NAME 

tk - paginator for the Tektronix 4014 
SYNOPSIS 

tk [ -t ] [ -N ] [ -pi ] [ file ] 

DESCRIPTION 

The output of tk is intended for a Tektronix 4014 terminal. Tk arranges 
for 66 lines to fit on the screen, divides the screen into TV columns, and 
contributes an eight space page offset in the (default) single-column 
case. Tabs, spaces, and backspaces are collected and plotted when 
necessary. Teletype Model 37 half- and reverse-line sequences are inter¬ 
preted and plotted. At the end of each page tk waits for a newline (empty 
line) from the keyboard before continuing on to the next page. In this 
wait state, the command '.command will send the command to the shell. 

The command line options are: 

-t Don't wait between pages; for directing output into a file. 

—N Divide the screen into TV columns and wait after the last column. 

—pZ, Set page length to L lines. 

SEE ALSO 

pr(l) 
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NAME 

touch — update date last modified of a file 
SYNOPSIS 

touch [ —c ] file ... 

DESCRIPTION 

Touch, attempts to set the modified date of each file. This is done by read¬ 
ing a character from the file and writing it back. 

If a file does not exist, an attempt will be made to create it unless the -c 
option is specified. 
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NAME 

tplot - graphics filters 
SYNOPSIS 

tplot [ —Tterminal [ —e raster ] ] 

DESCRIPTION , , , 

These commands read plotting instructions (see plot(5)) from the stan¬ 
dard input and in general produce, on the standard output, plotting 
instructions suitable for a particular terminal. If no terminal is 
specified, the environment parameter STERH (see environ(7)) is used. 
Known terminals are: 

300 DASI 300. 

300S DASI 300s. 

450 DASI 450. 

4014 Tektronix 4014. 

ver Versatec D1200A. This version of plot places a scan-converted 

image in /usr/trop/rasterSS and sends the result directly to the 
plotter device, rather than to the standard output. The -e option 
causes a previously scan-converted file raster to be sent to the 
plotter. 

FILES 

/usr/lib/t300 

/usr/lib/t300s 

/usr/lib/t450 

/usr/lib/t4014 

/usr/lib/vplot 

/usr/tmp/rasterSS 

SEE ALSO 

plot(3X). plot(5), term(7). ,, 
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NAME 

tr — translate characters 
SYNOPSIS 

tr [ —cds ] [ string 1 [ string2 ] J 

DESCRIPTION . L . . 

7V copies the standard input to the standard output with substitution or 
deletion of selected characters. Input characters found in string 1 are 
mapped into the corresponding characters of string2. When string2 is 
short it is padded to the length of string 1 by duplicating its last charac¬ 
ter. Any combination of the options -cds may be used: -c complements 
the set of characters in string 1 with respect to the universe of charac¬ 
ters whose ASCII codes are 01 through 0377 octal: -d deletes all input 
characters in string 1; -s squeezes all strings of repeated output charac¬ 
ters that are in string2 to single characters. 

In either string the notation a—6 means a range of characters from a to 
b in increasing ASCII order. The character V followed by 1. 2 or 3 octal 
digits stands for the character whose ASCII code is given by those digits. 
A '\' followed by any other character stands for that character. 

The following example creates a list of all the words in 'filel' one per line 
in ‘file2‘. where a word is taken to be a maximal string of alphabetics. 
The second string is quoted to protect 'V from the Shell. 012 is the 
ASCII code for newline. 

tr -cs A-Za-z '\012' <filel >file2 


SEE ALSO 

ed(l), ascii(7) 

BUGS 

Won t handle ASCII NUL in string 1 or stting2; always deletes NUL from 
input. 
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NAME 

troff. nroff - typeset or format text 
SYNOPSIS 

nroff [ options ] [ Ales ] 
troff [ options ] [ Ales ] 

DESCRIPTION 

Nroff formats text contained in flies (standard input by default) for 
printing on typewriter-like devices and line printers; similarly, troff for¬ 
mats text for a Wang Laboratories. Inc., C/A/T phototypesetter. Their 
capabilities are described in the NROFF/TROFF User's Manual cited 
below. 

An argument consisting of a minus (—) is taken to be a Ale name 
corresponding to the standard input. The options, which may appear in 
any order, but must appear before the flies, are: 

—olist Print only pages whose page numbers appear in the list of 

numbers and ranges, separated by commas. A range N—M 
means pages N through If; an initial —N means from the begin¬ 
ning to page N; and a Anal N— means from N to the end. (See 
BUGS below.) 

—n.V . Number Arst generated page N. 

—s,V Stop every N pages. Nroff will halt after every N pages (default 

N-l) to allow paper loading or changing, and will resume upon 
receipt of a line-feed or new-line (new-lines do not work in 
pipelines, e.g., with mm(l)). This option does not work if the 
output of nroff is piped through coi(l). Troff will stop the pho¬ 
totypesetter every N pages, produce a trailer to allow changing 
cassettes, and resume when the typesetter’s start button is 
pressed. When nroff {troff) halts between pages, an ASCII BEL 
(in troff, the message page stop) is sent to the terminal. 

—ro N Set register o (which must have a one-character name) to N. 

-i Read standard input after flies are exhausted. 

—q Invoke the simultaneous input-output mode of the .rd request. 

—z Print only messages generated by .tm (terminal message) 

requests. 

—rnname Prepend to the input flies the non-compacted (ASCII text) 
macro Ale /usr/lib/tmac/troac.nome. 

-cname Prepend to the input flies the compacted macro Ales 
/usr/Ub/macros/cmp.[nt].[dt] .name and 
/usr/lib/macros/ucmp.[nt).nome. 

—k name Compact the macros used in this invocation of nroff/troff, 
placing the output in Ales [dt).nome in the current directory 
(see the May 1979 Addendum to the NROFF/TROFF User's 
Manual tor details of compacting macro Ales). 

Nroff only: 

—T name Prepare output for specified terminal. Known names are 37 
for the (default) TELETYPE* Model 37 terminal. tn300 for the GE 
TermiNet 300 (or any terminal without half-line capability), 
300s for the DAS1 300s. 300 for the DASI 300. 450 for the DASI 
450, lp for a (generic) ASCII line printer, 382 for the DTC-3B2. 
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4000A for the Trendata 4000A. 832 for the Anderson Jacobson 
832. X for a (generic) EBCDIC printer, and 2631 for the Hewlett 
Packard 2631 line printer. 

—e Produce equally-spaced words in adjusted lines, using the full 

resolution of the particular terminal. 

-h Use output tabs during horizontal spacing to speed output and 

reduce output character count. Tab settings are assumed to 
be every 8 nominal character widths. 

-un Set the emboldening factor (number of character overstrikes) 
for the third font position (bold) to n, or to zero if n is missing. 


Troff only: 
-t 


-f 



—a 

-pN 


-e 


—Tname 


Direct output to the standard output instead of the photo¬ 
typesetter. 

Refrain from feeding out paper and stopping phototypesetter 
at the end of the run. 

Wait until phototypesetter is available, if it is currently busy. 
Report whether the phototypesetter is busy or available. No 
text processing is done. 

Send a printable ASCII approximation of the results to the stan¬ 
dard output. ' 

Print all characters in point size N while retaining all 
prescribed spacings and motions, to reduce phototypesetter 
elapsed time. 

Prepare output for the Murray Hill Computation Center photo- 
typesetter and direct it to the standard output (see jcaf(lC)). 
This option is not compatible with the —a option; furthermore, 
when this option is invoked, all ip (font position) requests (if 
any) in the troff input must come before the first break, and 
no .tl requests may come before the first break. 

Use font-width tables for device name (the font tables are 
found in /usr/lib/font/name/*). Currently, no names are 
supported. 


FILES 


/usr/lib/suftab 

/tmp/taS# 

/usr/lib/tmac/tmac.* 
/usr/lib/macros/* 
/usr/lib/term/* 
/usr/lib/font/* 


suffix hyphenation tables 
temporary file 

standard macro files and pointers 
standard macro files 
terminal driving tables for nroff 
font width tables for troff 


SEE ALSO 

NROFF/TROFF User's Manual by J. F. Ossanna. 
A TROFF Tutorial by B. W. Kernighan. 
eqn(l), tbl(l). mm(7). 
col(l). greek(l), mm(l) (nroff only). 
gcat(lC), mmt(l). tc(l). mv(7) ( troff only). 


Nroff /troff believes in Eastern Standard Time; as a result, depending on 
the time of the year and on your local time zone, the date that 
nroff /troff generates may be off by one day from your idea of what the 
date is. 
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' When nroff/troff is used with the -o list option inside a pipeline (e g . 
with one or more of eu;(l). egn(l), and *61(1)). it may cause a harmless 
"broken pipe" diagnostic if the last page of the document is not specified 
in list. 
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NAME 

true, false — provide truth values 

SYNOPSIS 

true 

false 

DESCRIPTION 

True does nothing, successfully. False does nothing, unsuccessfully 
They are typically used in input to sfc(l) such as: 

while true 
do 

command 

done 

SEE ALSO 

sh(l) 

DIAGNOSTICS 

True has exit status zero, false nonzero. 
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NAME 

tsort — topological sort 

SYNOPSIS 

tsort [ file ] 

DESCRIPTION 

Tsort produces on the standard output a totally ordered list of items 
consistent with a partial ordering of items mentioned in the input file. If 
no file is specified, the standard input is understood. 

The input consists of pairs of items (nonempty strings) separated by 
blanks. Pairs of different items indicate ordering. Pairs of identical 
items indicate presence, but not ordering. 

SEE ALSO 

lorder(l) 

DIAGNOSTICS 

Odd data: there is an odd number of fields in the input file. 

BUGS 

Uses a quadratic algorithm; not worth fixing for the typical use of order¬ 
ing a library archive file. 
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NAME 

tty — get terminal name 

SYNOPSIS 

tty 

DESCRIPTION 

Tty prints the pathname of the user's terminal. 
DIAGNOSTICS 

not a tty' if the standard input file is not a terminal. 
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NAME 

ul — do underlining 
SYNOPSIS 

ul [ — ii ] [ —t terminal ] [ name ... ] 

DESCRIPTION 

Ul reads the named files (or standard input if none are given) and 
translates occurances of underscores to the sequence which indicates 
underlining for the terminal in use. as specified by the environment vari¬ 
able TERM. The —t option overrides the terminal kind specified in the 
environment. The file /etc/termcap is read to determine the appropriate 
sequences for underlining. If the terminal is incapable of underlining, 
but is capable of a standout mode then that is used instead. If the termi¬ 
nal can overstrike, or handles underlining automatically, ul degenerates 
to caf (1). If the terminal cannot underline, underlining is ignored. 

The —i option causes ul to indicate underlining onto by a separate line 
containing appropriate dashes this is useful when you want to look at 
the underlining which is present in an rvroff output stream on a crt- 
terminal. 

SEE ALSO 

man(l), nroff(l). colcrt(l) 

AUTHOR 

Mark Horton 

BUGS 

Nroff usually outputs a series of backspaces and underlines intermixed 
with the text to indicate underlining. No attempt is made to optimize the 
backward motion. 
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NAME 

umask - set file-creation mode mask 

SYNOPSIS 

umask [ ooo ] 

DESCRIPTION 

The user file-creation mode mask is set to ooo. The three octal digits 
refer to read/write/execute permissions for owner, group, and others, 
respectively (see chmod( 2) and uma$i(2)). The value of each specified 
digit is subtracted from the corresponding “digit" specified by the sys¬ 
tem for the creation of a file (see creaf(2)). For example, umask 022 
removes group and of/ters write permission (files normally created with 
mode 777 become mode 755; files created with mode 666 become mode 
644). 

If ooo is omitted, the current value of the mask is printed. 

Umask is recognized and executed by the shell. 

SEE ALSO 

chmod(l), sh(l), chmod(2), creat(2), umask(2). 


Page 1 


February 20. 1.984 









UNAME(l) 


liUNIX 


UNAME(l) 


NAME 

uname — print name of current UNIX 

SYNOPSIS 

uname [ —snrva ] 

DESCRIPTION 

Uname prints the current system name of UNIX on the standard output 
file. It is mainly useful to determine what system one is using. The 
options cause selected information returned by uname(2) to be printed: 

—s print the system name (default). 

—n print the nodename (the nodename may be a name that the sys¬ 

tem is known by to a communications network). 

—r print the operating system release. 

—v print the operating system version. 

—a print all the above information. 

SEE ALSO 

uname(2). 
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NAME 

unget — undo a previous get of an SCCS file 
SYNOPSIS 

unget [—rSID] [—s] [—n] files 
DESCRIPTION 

Unget undoes the effect of a get —e done prior to creating the intended 
new delta. If a directory is named, unget behaves as though each file in 
the directory were specified as a named file, except that non-SCCS files 
and unreadable files are silently ignored. If a name of — is given, the 
standard input is read with each line being taken as the name of an SCCS 
file to be processed. 

Keyletter arguments apply independently to each named file. 

—tSID Uniquely identifies which delta is no longer intended. 

(This would have been specified by get as the “new 
delta"). The use of this keyletter is necessary only if two 
or more outstanding gets for editing on the same SCCS 
file were done by the same person (login name). A diag¬ 
nostic results if the specified SID is ambiguous, or if it is 
necessary and omitted on the command line. 

—s Suppresses the printout, on the standard output, of the 

intended delta's SID. 

—n Causes the retention of the gotten file which would nor¬ 

mally be removed from the current directory. 

SEE ALSO 

delta(l), get(l), sact(l). 

DIAGNOSTICS 

Use help{ 1) for explanations. 
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NAME 

unify relational data base system 

SYNOPSIS 

unify 

DESCRIPTION 

UNIFY is a relational data base system. The UNIFY-system is a collection 
of about 20 different programs. The program unify allows you to login to 
the UNIFY system and use the other components via menus. 

SEE ALSO 

UNIFY - Reference Manual Version 3.0 
UNIFY - Tutorial Manual Version 3.0 
both copy right UNIFY Corp. 

BUGS 

UNIFY is known to be relatively stable. However in some applications 
UNIFY-components may run out of stack and produce a core dump. In 
this case enlage the stacksize (see stksiz(l)) of the program and try 
again. 
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NAME 

uniq - report repeated lines in a file 
SYNOPSIS 

uniq [ —udc [ +n ] [ -n ] ] [ input [ output ] ] 

DESCRIPTION 

Uniq reads the input file comparing adjacent lines. In the normal case, 
the second and succeeding copies of repeated lines are removed; the 
remainder is written on the output file. Note that repeated lines must be 
adjacent in order to be found; see sorf(l). If the —u flag is used, just the 
lines that are not repeated in the original file are output. The —d option 
specifies that one copy of just the repeated lines is to be written. The 
normal mode output is the union of the —u and —d mode outputs. 

The —c option supersedes —u and —d and generates an output report in 
default style but with each line preceded by a count of the number of 
times it occurred. 

The n arguments specify skipping an initial portion of each line in the 
comparison: 

—n The first n fields together with any blanks before each are 

ignored. A field is defined as a string of non-space, non-tab char¬ 
acters separated by tabs and spaces from its neighbors. 

+n The first n characters are ignored. Fields are skipped before 
characters. 

SEE ALSO 

sort(l), comm(l) 
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NAME 

units — conversion program 

SYNOPSIS 

units 

DESCRIPTION 

Units converts quantities expressed in various standard scales to their 
equivalents in other scales. It works interactively in this fashion: 

You have: inch 
You want: cm 

* 2.54000e+00 
/ 3.9370le-01 

A quantity is specified as a multiplicative combination of units optionally 
preceded by a numeric multiplier. Powers are indicated by suffixed posi¬ 
tive integers, division by the usual sign: 

You have: 15 pounds force/in2 
You want: atm 

• 1.02069e+00 
/ 9.79730e—0l 

Units only does multiplicative scale changes. Thus it can convert Kelvin 
to Rankine, but not Centigrade to Fahrenheit. Most familiar units, abbre¬ 
viations, and metric prefixes are recognized, together with a generous 
. leavening of exotica and a few constants of nature including: 

pi ratio of circumference to diameter 

c speed of light 

e charge on an electron 

g acceleration of gravity 

force same as g 

mole Avogadro's number 

water pressure head per unit height of water 

au astronomical unit 

’Pound' is a unit of mass. Compound names are run together, e.g. *ligh- 
tyear’. British units that differ from their US counterparts are prefixed 
thus: •brgallon'. Currency is denoted *belgiumfranc\ ‘britainpound’.... 

For a complete list of units, ‘cat /usr/lib/units’. 

FILES 

/usr/lib/units 

BUGS 

Don’t base your financial plans on the currency conversions. 
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NAME 

uptime - show how long system has been up 


SYNOPSIS 

uptime 

DESCRIPTION 

Uptime prints the current time and the length of time the system has 
been up. It is, essentially, the first line of a u>(l) command. 


FILES 

/unix system name list 

SEE ALSO 
w(l) 
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NAME 

users — compact list of users who are on the system 

SYNOPSIS 

users 

DESCRIPTION 

Users lists the login names of the users currently on the system in a com¬ 
pact. one-line format. 

FILES 

/etc/utmp 

SEE ALSO 

finger(l), who(l) 

BUGS 
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NAME 

uucp, uulog, uuname — unix to unix copy 
SYNOPSIS 

uucp [ option ] ... source-file ... destination-file 
uulog [ option ] ... 
uuname 
DESCRIPTION 

Uucp copies files named by the J source-file arguments to the 
destination-file argument. A file name may be a path name on your 
machine, or may have the form: 
system-name!path-name 

where system-name is taken from a list of system names which uucp 
knows about. Shell metacharacters ?•[] appearing in path-name will be 
expanded on the appropriate system. 

Path names may be one of: 

(1) a full path name; 

(2) a path name preceded by -user where user is a login name on the 
specified system and is replaced by that user's login directory; 

(3) a path name preceded by ~/user where user is a login name on 
the specified system and is replaced by that user’s directory 
under PUBD1R; 

(4) anything else is prefixed by the current directory. 

If the result is an erroneous path name for the remote system the copy 
will fail. If the destination-file is a directory, the last part of the source- 
file name is used. 

Uucp preserves execute permissions across the transmission and give- 
0666 read and write permissions (see chmod{2)). 

The following options are interpreted by uucp: 

—d Make all necessary directories for the file copy (default). 

-f Do not make intermediate directories for the file copy. 

—c Use the source file when copying out rather than copying the file t< 

the spool directory (default). 

-C Copy the source file to the spool directory. 

-m Send mail to the requester whe'h the copy is complete. 

—n user 

Notify user on the remote system that a file was sent. 

Send the uucp command to system sys to be executed there. (Not 
— this will only be successful if the remote machine allows the true 
command to be executed by /usr/lib/uucp/uuxqt.) 

Uulog maintains a summary log of uucp and uux(lC) transactions in th 
file /usr/spool/uucp/LOGFILE by gathering information from partial la 
files named /usr/spool/uucp/LOG.*.?. (These files will only be created 
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the LOGFILE is being used by another process.) It removes the partial log 
files. 

The options cause uulog to print logging information: 

—ssys 

Print information about work involving system sys. 

—u user 

Print information about work done for the specified user. 

Uuname lists the uucp names of known systems. The —1 option returns 
the local system name. 

FILES 

/usr/spool/uucp 

spool directory 
/usr/spool/uucppublic 

public directory for receiving and sending (PUBDIR) 
/usr/lib/uucp/ • 

other data and program files 

SEE ALSO 

mail(l). uux(lC). uuto(lC), uupick(lC). 

Uucp Implementation Description by D. A. Nowitz. 

WARNING 

The domain of remotely accessible files can (and for obvious security 
reasons, usually should) be severely restricted. You will very likely not 
be able to fetch files by path name; ask a responsible person on the 
remote system to send them to you. For the same reasons you will prob¬ 
ably not be able to send files to arbitrary path names. As distributed, the 
remotely accessible files are those whose names begin 
/usr/spool/uucppublic (equivalent to ~nuucp or just ~). 

BUGS 

All files received by uucp will be owned by uucp. 

The -m option will only work sending files or receiving a single file. 
(Receiving multiple files specified by special shell characters ?•[] will not 
activate the —m option.) 
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NAME 


uustat - uucp status inquiry and job control 


SYNOPSIS 

uustat [ option ] ... 

DESCRIPTION 

Uustat will display the status of. or cancel, previously specified uucp 
commands, or provide general status on uucp connections to other sys¬ 
tems. The following options are recognized: 

—m mch Report the status of accessibility of machine mch. If mch is 
specified as all, then the status of all machines known to the 
local uucp are provided. 

—ly'obn Kill the uucp request whose job number is jobn. The killed uucp 
request must belong to the person issuing the uustat command 
unless he is the super-user. 

—c hour Remove the status entries which are older than hour hours. 

This administrative option can only be initiated by the user 
uucp or the super-user. 

—uitser Report the status of all uucp requests issued by user. 

—s sys Report the status of all uucp requests which communicate with 

remote system sys. 

—o hour Report the status of all uucp requests which are older than 
hour hours. 

—yhour Report the status of all uucp requests which are younger than 
hour hours. 

— jail Report the status of all the uucp requests. 

—v Report the uucp status verbosely. If this option is not specified, 

a status code is printed with each uucp request. 

When no options are given, uustat outputs the status of all uucp requests 
issued by the current user. Note that only one of the options —j, —m, —k, 
—c, or the rest of other options may be specified. 

For example, the command 

uustat —uhdc — smhtsa —y72 —v 

will print the verbose status of all uucp requests that were issued by user 
hdc to communicate with system mhtsa within the last 72 hours. The 
meanings of the job request status are: 

job-number user remote-system command-time status-time status 

where the sfafus may be either an octal number or a verbose descrip¬ 
tion. The octal code corresponds to the following description: 

OCTAL 
00001 
00002 
00004 
00010 
00020 
00040 
00100 
00200 


STATUS 

the copy failed, but the reason cannot be determined 

permission to access local file is denied 

permission to access remote file is denied 

bad uucp command is generated 

remote system cannot create temporary file 

cannot copy to remote directory 

cannot copy to local directory 

local system cannot create temporary file 
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00400 cannot execute uucp 
01000 copy succeeded 

02000 copy finished, job deleted 

04000 job is queued 


The meanings of the machine accessibility status are: 
system-name time status 

where time is the latest status time and status is 
description of the machine status. 

FILES 

/usr/spool/uucp 

spool directory 
/usr/lib/uucp/L_stat 

system status file 
/usr/lib/uucp/R_stat 

request status file 


SEE ALSO 

uucp(lC). 

Uustat — A UUCP Status Inquiry Program, by H. Che. 


self-explanatory 
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NAME 

uuto, uupick — public UNDC-to-UNIX file copy 
SYNOPSIS 

uuto [ options ] source-files destination 
uupick [ —s system ] 

DESCRIPTION 

Uuto sends source-files to destination. Uuto uses the uucp (1C) facility 
to send files, while it allows the local system to control the file access. A 
source-file name is a path name on your machine. Destination has the 
form: 

systemh iser 

where system is taken from a list of system names that uucp knows 
about (see uuname(lC)). Logname is the login name of someone on the 
specified system. 

Two options are available: 

—p Copy the source file into the spool directory before transmission, 

-m Send mail to the sender when the copy is complete. 

The files (or sub-trees if directories are specified) are sent to PUBDIR on 
system, where PUBDIR is a public directory defined in the uucp source. 
Specifically the files are sent to 

PUBDIR/receive/user/mysysfem/flles. 

The destined recipient is notified by mati(l) of the arrival of files. 

Uupick accepts or rejects the files transmitted to the user. Specifically. 
uupick searches PUBDIR for files destined for the user. For each entry 
(file or directory) found, the following message is printed on the standard 
output: 

from system: [file file-name] [dir dirmxms] ? 

Uupick then reads a line from the standard input to determine the dispo¬ 
sition of the file: 

<new-line> Go on to next entry. 


d Delete the entry. 

m [ dir ] Move the entry to named directory dir (current directory 
is default). 

a [ dir ] Same as m except moving all the files sent from sysfem. 


p Print the content of the file. 

q Stop. 

EOT (control-d) 

Same as q. 

Jcommand Escape to the shell to do command. 

• Print a command summary. 

Uupick invoked with the -asysfem option will only search the PUBDIR for 
files sent from sysfem. 
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FILES 

PUBDIR /usr/spool/uucppublic public directory 

SEE ALSO 

mail(l). uuclean(8), uucp(lC), uulog(lC), uuname(lC). uustat(lC), 
uux(lC). 
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NAME 

uux - unix to unix command execution 
SYNOPSIS 

uux [ — ] command-string 
DESCRIPTION 

Uux will gather zero or more flies from various systems, execute a com¬ 
mand on a specified system and then send standard output to a file on a 
specified system. Note that, for security reasons, many installations will 
limit the list of commands executable on behalf of an incoming request 
from uux. Many sites will permit little more than the receipt of mail (see 
maii(l)) via uux. 

The command-string is made up of one or more arguments that look like 
a Shell command line, except that the command and Ale names may be 
prefixed by system-name!. A null system-name is interpreted as the 
local system. 

File names may be one of 

(1) a full path name; 

(2) a path name preceded by ~xxx where xxx is a login name on 
the specified system and is replaced by that user’s login directory; 

(3) anything else is prefixed by the current directory. 

The — option will cause the standard input to the uux command to be the 
standard input to the command-sfrinp. For example, the command 

uux "Jdiff usg!/usr/dan/fl pwba!/a4/dan/fl > Jfl.diff” 

will get the fl files from the ”usg" and "pwba" machines, execute a diff 
command and put the results in fl.difT in the local directory. 

Any special shell characters such as < > ; | should be quoted either by 
quoting the entire command-string, or quoting the special characters as 
individual arguments. 

Uux will attempt to get all files to the execution system. For files which 
are output files, the file name must be escaped using parentheses. For 
example, the command 

uux a!uucp b!/usr/flle \(c!/usr/flle\) 

will send a uucp command to system “a” to get /uar/file from system ’’b" 
and send it to system “c". 

Uux will notify you if the requested command on the remote system was 
disallowed. The response comes by remote mail from the remote 
machine. 

FILES 

/usr/lib/uucp/spool 

spool directory 

/usr/lib/uucp/* other data and programs 

SEE ALSO 

uuclean(S), uucp(lC). 

Uucp Implementation Description by D. A. Nowitz 
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BUGS 


Only the first command of a shell pipeline may have a system-name!. All 
other commands are executed on the system of the first command. 

The use of the shell metacharacter • will probably not do what you want 
it to do. The shell tokens « and » are not implemented. 
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NAME 

val — validate SCCS file 

SYNOPSIS 

val — 

val [—a] [-rSID] [-mname] [-ytype] files 
DESCRIPTION 

Val determines if the specified Jilt is an SCCS file meeting the charac¬ 
teristics specified by the optional argument list. Arguments to val may 
appear in any order. The arguments consist of keyletter arguments, 
which begin with a —. and named files. 

Val has a special argument, —. which causes reading of the standard 
input until an end-of-file condition is detected. Each line read is 
independently processed as if it were a command line argument list. 

Val generates diagnostic messages on the standard output for each com¬ 
mand line and file processed and also returns a single 8-bit code upon 
exit as described below. 

The keyletter arguments are defined as follows. The effects of any 
keyletter argument apply independently to each named file on the com¬ 
mand line. 

—s The presence of this argument silences the diagnostic 

message normally generated on the standard output 
for any error that is detected while processing each 
named file on a given command line. 

-rSID The argument value SID (SCCS ZDentification String) is 

an SCCS delta number. A check is made to determine 
if the SID is ambiguous (e. g.. rl is ambiguous because 
it physically does not exist but implies 1.1, 1.2. etc. 
which may exist) or invalid (e. g.. rl.O or rl.1.0 are 
invalid because neither case can exist as a valid delta 
number). If the SID is valid and not ambiguous, a 
check is made to determine if it actually exists. 


-mname The argument value name is compared with the SCCS 
%M?5 keyword in file. 

-ytype The argument value type is compared with the SCCS 

keyword in/Me. 

The 8-bit code returned by val is a disjunction of the possible errors, 
i. e., can be interpreted as a bit string where (moving from left to right) 
set bits are interpreted as follows: 


bit 0 = missing file argument; 

bit 1 = unknown or duplicate keyletter argument; 

bit 2 = corrupted SCCS file; 

bit 3 = can't open file or file not SCCS; 

bit 4 = SID is invalid or ambiguous; 

bit 5 = SID does not exist; 

bit 6 = %YJ5, —y mismatch; 

bit 7 = ZMZ, —m mismatch: 
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Note that val can process two or more files on a given command line and 
in turn can process multiple command lines (when reading the standard 
input). In these cases an aggregate code is returned — a logical OR of the 
codes generated for each command line and file processed. 

SEE ALSO 

admin(l), delta(l), get(l), prs(l). 

DIAGNOSTICS 

Use help(l) for explanations. 

BUGS 

Val can process up to 50 files on a single command line. Any number 
above 50 will produce a core dump. 
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NAME 

vc - version control 
SYNOPSIS 

▼c [-t] [-cchar] [-•] [keyword*value ... keyword*value] 
DESCRIPTION 

The vc command copies lines from the standard input to the standard 
output under control of its arguments and control statements encoun¬ 
tered in the standard input. In the process of performing the copy 
operation, user declared keywords may be replaced by their string value 
when they appear in plain text and/or control statements. 

The copying of lines from the standard input to the standard output is 
conditional, based on tests (in control statements) of keyword values 
specified in control statements or as vc command arguments. 

A control statement is a single line beginning with a control character 
except as modified by the -t keyletter (see below). The default control 
character is colon (:). except as modified by the -c keyletter (see below). 
Input lines beginning with a backslash (\) followed by a control charac¬ 
ter are not control lines and are copied to the standard output with the 
backslash removed. Lines beginning with a backslash followed by a non- 
control character are copied in their entirety. 

A keyword is composed of 9 or less alphanumerics; the first must be 
alphabetic. A value is any ASCII string that can be created with ed( 1); a 
numeric value is an unsigned string of digits. Keyword values may not 
contain blanks or tabs. 

Replacement of keywords by values is done whenever a keyword sur¬ 
rounded by control characters is encountered on a version control state¬ 
ment. The -a keyletter (see below) forces replacement of keywords in 
all lines of text. An uninterpreted control character may be included in 
a value by preceding it with V If a literal \ is desired, then it too must 
be preceded by \. 


Keyletter arguments 

_ a Forces replacement of keywords surrounded by con¬ 

trol characters with their assigned value in all text 
lines and not just in vc statements. 

All characters from the beginning of a line up to and 
including the first tab character are ignored for the 
purpose of detecting a control statement. If one is 
found, all characters up to and including the tab are 
discarded. 

—cchar Specifies a control character to be used in place of:. 

_ s Silences warning messages (not error) that are nor¬ 

mally printed on the diagnostic output. 

Version Control Statements 

:dcl keyword[.keyword] , . , , 

Used to declare keywords. All keywords must be declared. 
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:asg keyword=value 

Used to assign values to keywords. An asg statement overrides the 
assignment for the corresponding keyword on the vc command line 
and all previous asg's for that keyword. Keywords declared, but not 
assigned values have null values. 

:if condition 


:end 

Used to skip lines of the standard input. If the condition is true all 
lines between the if statement and the matching end statement are 
copied to the standard output. If the condition is false, all interven¬ 
ing lines are discarded, including control statements. Note that 
intervening if statements and matching end statements are recog¬ 
nized solely for the purpose of maintaining the proper if-end match¬ 
ing. 

The syntax of a condition is: 


<cond> 

<or> 

<and> 

<exp> 

<op> 

<value> 


= [ "not'' ] <or> 

= <and> | <and> "I" <or> 

= <exp> | <exp> ”lc" <and> 

= "(" <or> ")" | <value> <op> <value> 

= "=" I | "<" | ">" 

= <arbitrary ASCII string> | <numeric string> 


The available operators and their meanings are: 


= equal 

!= not equal 

6c and 

I or 

> greater than 

< less than 

( ) used for logical groupings 

not may only occur immediately after the if. and 

when present, inverts the value of the 
entire condition 


The > and < operate only on unsigned integer values (e. g.: 012 > 12 
is false). All other operators take strings as arguments (e. g.: 012 != 
12 is true). The precedence of the operators (from highest to 
lowest) is: 

= != > < all of equal precedence 
& 

I 

Parentheses may be used to alter the order of precedence. 

Values must be separated from operators or parentheses by at least 
one blank or tab. 

::text 

Used for keyword replacement on lines that are copied to the stan¬ 
dard output. The two leading control characters are removed, and 
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keywords surrounded by control characters in text are replaced by 
their value before the line is copied to the output file. This action is 
independent of the —a keyletter. 

:on 

:off 

Turn on or off keyword replacement on all lines. 

:ctl char 

Change the control character to char. 

:msg message 

Prints the given message on the diagnostic output. 

:err message 

Prints the given message followed by: 

ERROR: err statement on line ... (915) 
on the diagnostic output. Vc halts execution, and returns an exit 
code of 1. 

DIAGNOSTICS 

Use help{\) for explanations. 

EXIT CODES 

0 — normal 
1 — any error 
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NAME 

vfoniinfo — 

SYNOPSIS 

vfontinfo [ 


inspect and print out information about fonts 
—▼ ] fontname [ characters ] 


Yfontinfo allows you to examine a font in the UNIX format. It prints out 
all the information in the font header and information about every non¬ 
null (width > 0) glyph. This can be used to make sure the font is con¬ 
sistent with the format. 

The fontname argument is the name of the font you wish to inspect. It 
writes to standard output. If it can’t find the file in your working direc¬ 
tory. it looks in Aisr/lib/vfont (the place most of the fonts are kept). 

The characters, if given, specify certain characters to show. If omitted, 
the entire font is shown. 

If the -▼ (verbose) flag is used, the bits of the glyph itself are shown as 
an array of X’s and spaces, in addition to the header information. 


SEE ALSO 

vfont(5) 

The Berkeley Font Catalog 


AUTHORS 

Mark Horton 
Andy Hertzfeld 
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NAME 

vi - screen oriented (visual) display editor based on ex 

SYNOPSIS , r , r , , r i r 1 

vi [ —t tag ) [ -r file ] [ +command )[—!][ —wn J [ -x J name ... 


DESCRIPTION , L 

Vi (visual) is a display oriented text editor based on an underlying line 
editor ex(l). It is possible to use the command mode of ex from within vi 
and vice-versa. 


When using vi changes you make to the file are reflected in what you see 
on your terminal screen. The position of the cursor on the screen indi¬ 
cates the position within the file. The Vi Quick Reference card and the 
Introduction to Display Editing with Vi provide full details on using vi. 


INVOCATION . . 

The following invocation options are interpreted by vi: 

-ttag Edit the file containing the tag and position the editor at 

its definition. 


—r file 
+command 
-1 


—wn 


Recover file after an editor or system crash. If file is not 
specified a list of all saved flies will be printed. 

Begin editing by executing the specified editor search or 
positioning command . 

LISP mode: indents appropriately for lisp code, the ()(}[[ 
and j] commands in vi and open are modified to have 
meaning for lisp . 

Set the default window size to n. This is useful when using 
the editor over a slow speed line. 


_ x Encryption mode; a key is prompted for allowing creation 

or editing of an encrypted file. 

The name argument indicates files to be edited. 


"VI STATES" 

Command 


Insert 


Last line 


Normal and iniUal state. Other states return to command 
state upon completion. ESC (escape) is used to cancel a 
partial command. 

Entered byaiAIoOcCsSR Arbitrary text may then be 
entered. Insert is normally terminated with ESC character, 
or abnormally with interrupt. 

Reading input for : / ? or !; terminate with ESC or CR to 
execute, interrupt to cancel. 


COMMANDS 

Counts before vi commands 

line/column number z G | 
scroll amount ~D “U 

replicate insert a i A 1 

repeat effect most of the rest 


Sample commands 

dw 


delete a word 
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de 

... leaving white space 

dd 

delete a line 

3dd 

... 3 lines 

ifexfESC 

insert text abc 

cwnetuESC 

change word to new 

easESC 

pluralize word 

xp 

transpose characters 

ZZ 

exit vi 

Interrupting, canceling 

ESC 

end insert or incomplete cmd 


(delete or rubout) interrupts 


reprint screen if ~? scrambles 

File manipulation 

:w 

write back changes 

nrq 

write and quit 

:q 

quit 

:q! 

quit, discard changes 

:e name 

edit file name 

:e! 

reedit, discard changes 

:e + name 

edit, starting at end 

:e +n 

edit starting at line n 

:e # 

edit alternate file 

a 

synonym for :e f 

rw name 

write file name 

:w! name 

overwrite file name 

:sh 

run shell, then return 

:!cmd 

run cmd, then return 

:n 

edit next file in arglist 

:n arys 

specify new arglist 

:f 

show current file and line 

~G 

synonym for :f 

:ta fay 

to tag file entry tag 


:ta, following word is fay 

Positioning within file 

~F 

forward screen 

~B 

backward screen 

-D 

scroll down half screen 

-U 

scroll up half screen 

G 

goto line (end default) 

/pat 

next line matching pat 

?pat 

prev line matching pat 

n 

repeat last / or ? 

N 

reverse last / or ? 

/paf/+n 

n’th line after j>af 

?pat?—n 

n'th line before pat 

]] 

next section/function 

[[ 

previous section/function 

% 

find matching ( ) i or | 

Adjusting the 

screen 

~L 

clear and redraw 
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~R 

retype, eliminate © lines 

zCR 

redraw, current at window top 

z— 

... at bottom 

z. 

... at center 

/pat/z- 

pat line at bottom 

zn. 

use n line window 

-E 

scroll window down 1 line 


scroll window up 1 line 

Marking and returning 


previous context 

*0 

... at first non-white in line 

mi 

mark position with letter x 

'x 

to mark x 

'X 

... at first non-white in line 

Line positioning 

H 

home window line 

L 

last window line 

M 

middle window line 

+ 

next line, at first non-white 

— 

previous line, at first non-white 

CR 

return, same as + * 

i or j 

next line, same column 

t or k 

previous line, same column 

Character positioning 

A 

first non white 

0 

beginning of line 

s 

end of line 

hor-* 

forward 

1 or «- 

backwards 

-H 

same as «- 

space 

same as -* 

fx 

find x forward 

Fx 

f backward 

tx 

upto x forward 

Tx 

back upto x 

• 

repeat last f F t or T 

• 

inverse of ; 

1 

to specified column 

7. 

find matching ( | ) or { 


Words, sentences, paragraphs 
w word forward 

b back word 

e end of word 

) to next sentence 

I to next paragraph 

( back sentence • 

I back paragraph 

W blank delimited word 

B back W 

E to end of W 
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Commands for LISP Mode 

) Forward s-expression 

{ ... but don’t stop at atoms 

( Back s-expression 

J ... but don’t stop at atoms 


Corrections 

~H 

-TT 

erase 

kill 

\ 

ESC 

~D 

t~D 

0~D 

-V 


during insert 
erase last character 
erase last word 
your erase, same as “H 
your kill, erase input this line 
escapes '•H, your erase and kill 
ends insertion, back to command 
interrupt, terminates insert 
backtab over autoindent 
kill oufoindenf, save for next 
... but at margin next also 
quote non-printing character 


Insert and replace 

a append after cursor 

i insert before 

A append at end of line 

1 insert before first non-blank 

o open line below 

O open above 

rx replace single char with x 

R replace characters 

Operators (double to affect lines) 
d delete 

c change 

< left shift 

> right shift 

! filter through command 

= indent for LISP 

y yank lines to buffer 


Miscellaneous operations 

C change rest of line 

D delete rest of line 

s substitute chars 

S substitute lines 

J join lines 

x delete characters 

X ... before cursor 

Y yank lines 


Yank and put 

p put back lines 

P put before 

"xp put from buffer x 

"xy yank to buffer x 

"xd delete into buffer x 
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Undo, redo, retrieve 

u undo last change 

U restore current line 

repeat last change 
"dp retrieve cf'th last delete 

AUTHOR 

Vi and ex are based on software developed by The Unviersity of Califor¬ 
nia, Berkeley California, Computer Science Division. Department of 
Electrical Engineering and Computer Science. 

SEE ALSO 

ex (1). "Vi Quick Reference” card and "An Introduction to Display Edit¬ 
ing with Vi", in the UNIX System Document Processing Guide. 

CAVEATS AND BUGS 

Software tabs using ~T work only immediately after the autoindent. 

Left and right shifts on intelligent terminals don’t make use of insert and 
delete character operations in the terminal. 

The wrapmargin option can be fooled since it looks at output columns 
when blanks are typed. If a long word passes through the margin and 
onto the next line without a break, then the line won’t be broken. 

Insert/delete within a line can be slow if tabs are present on intelligent 
terminals, since the terminals need help in doing this correctly. 

Sa\ing text on deletes in the named buffers is somewhat inefficient. 

The source command does not work when executed as rsource; there is no 
way to use the :append, .change, and rinsert commands, since it is not 
possible to give more than one line of input to a : escape. To use these 
on a .-global you must Q to ex command mode, execute them, and then 
reenter the screen editor with vi or open. 
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NAME 

vsh ~ Visual Shell PCS Version 3.97 

SYNOPSIS 

vsh 

DESCRIPTION 

Vsh is a highly interactive, screen oriented program which simplifies 
access to the normal Unix shell and the file system and eases many pro¬ 
gramming activities. Vsh can be used as a front-end interface to the 
Unix system for program development and normal applications Most 
commands involve only a single keystroke. There are commands in vsh 
that cause directories or text files to be displayed, editors to be called, 
compilers to be invoked, etc.. 

On entry to vsh (ie. after typing in the shell command vsh ), the user’s 
current directory is plotted on the screen. This is called a directory 
page. The top line of the directory page displays the directory’s name. 
Each file in the directory is labeled with a letter (a through t for up to 
twenty files per page (on a normal terminal)). 

To select a file, one presses its corresponding letter. What happens after 
selection of a file depends on the nature (file type) of the file. If the file 
is a directory, vsh changes to that directory (similar to the shell com¬ 
mand cd ). For text files vsh calls the user’s default editor (set in 
his/her environment). There are several other cases for different types 
of files. Full details of this mechanism (automatic file selection) are 
given later. 

vsh displays up to twenty files at a time on a directory page. Directories 
which are larger are broken into pages of twenty-files each. The top line 
of the directory page displays the current page number and total 
number of pages in the working directory along with its name. There can 
be up to ten pages holding a total of two hundred files per directory. To 
select a page other than the current one, one can press a digit (0-9). 
Pages are numbered one through ten with 0 selecting page ten. There 
are several other commands for selecting pages (<RETURN>, for exam¬ 
ple) that are described below. In general in vsh there is more than one 
way to call the most common commands. This redundancy of command 
assignment can make it easier to learn vsh as well as simplifying the 
man-machine interface. 

A well integrated feature of Vsh is its connection between compilers and 
editors for program development. To start a compilation, one presses M. 
Vsh then calls on the Unix utility make. The output of this compilation 
from make is saved in a special file that one can later review in showfile 
mode for compile-time error messages. 

In showfile mode, vsh numbers each error message or compiler call in the 
showfile. One can select an error message by typing its line number. 
After selection of a line containing an error message, vsh reads the line 
trying to find a file name and a line number to call the text editor with 
the proper file at the offending line. For most normal compilers ( c, f77 
etc...) the format of compiler error messages is standardised and vsh can 
almost always find the filename and line number. One can jump between 
the editor and the vsh error listing until one is ready for another 
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compile. 

Because vsh is unconventional, the best way to understand how it works 
is by using it. Because vsh is menu driven, it is hard to get lost. The 
escape mechanism to the normal shell is trivial, one only needs to type 
<SPACE> before any shell command. Beginners should find vsh easier to 
learn then the conventional shell. . 


FILE SELECTION 

One selects a file from the current directory page by pressing its 
corresponding letter (a through t without <RETURN>). What happens 
after selection depends on the nature of the file selected. 


File type 


Action upon File Selection 


Text 

Directory 
Executable 
Object module 
Core Dump 


Call the user’s default text editor (usually vi or med and 
set in his .profile file). Like command vi file. 

Change to new (sub-) directory (lower in the tree). Like 
command cd file. 

(a.out format - 411 magic number) Prompt for input and 
try to execute. Like command file. 

(*.o format - 407 magic number) Print the namelist of 
the object module. Like command nm -ng file. 

Prompt for the name of the executable file that caused 
the core dump and call default debugger (adb). Like 
command adb a.out core. 


Archive library (ar or cpio) Print archive directory. Like command ar -vt 
file. 

Special File, 

Protected or 


Other 


Selection fails, vsh says it doesn't know what to do. 


DIRECTORY OPERATIONS 

This is a list of the directory commands. No <RETURN> is necessary after 
these commands (!!). Before doing anything else, the user should become 
familiar with commands which allow him to select files and display direc¬ 
tories. In directories larger then twenty files, the user should be able to 
display each page. 

This list contains only the main assignments of the directory commands. 
The command overview at the end of this document is a complete list of 
vsh operations and their key assignments. 

Command Action 

Q Leave vsh. Return to login shell. N.B. - vsh ignores ~c 

and ~z as interrupts on purpose and exits only with *Q‘ 
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a - t 

1 -9 
0 

<RETURN> 

\ 

/ 

<SPACE> 


u - z 


or ~d. 

Display help file. This describes the commands and 
options of Tsh There are several different help files for 
the different modes and pages of vsh 

Select the corresponding file from the current directory 
page. (See automatic file selection below) 

Select page 1-9 of current working directory. 

Select page 10. 

Select next page. 

Select previous page. 

Change to parent (next-higher) directory. ( cd ../ ) 
Change to home directory. 

Change to root directory. 

Escape for one command to the normal Unix shell, vsh 
prompts for a shell command (to be ended by 
<RETURN>) and uses your default (login) shell program. 
When the shell is finished, vsh prompts for *q’ to return 
to the directory page. Whenever the prompt "Press q 
to quit" comes, vsh is just waiting in case you want to 
copy something from the screen before the directory 
page comes back. Any character typed in after this 
prompt will do. 

(Comma) Escape to shell until ~z. vsh forks an interac¬ 
tive subshell. The shell prompt comes. Typing ~z 
(Control-z) to this shell returns to the directory page. 

User-definable extra file selectors. One can specify 6 
files for selection that may belong to any directory. 
With this mechanism one can have 6 files that are select¬ 
able from anywhere in the file hierarchy. 


S Shell environment parameter, vsh prompts with ’S’ and 

one can enter the name of any shell environment 
parameter. It will then be selected as a file. This coin; 
mand means that one can put a line like 
"w=s/usr/include/sys; export w;" in his/her .profile file 
and select this directory with "Sw<RETURN>”. There can 
be arbitrarily many such shell parameters. 

CAPITAL-LETTER COMMANDS 

These are the basic vsh commands and its most useful features. They can 
report system status, handle files, display information and alter the 
environment of vsh. 

Many commands ask (prompt) for input, a file name, for example. When 
typing these responses in, just as in the normal shell, typing <BACK- 
SPACE> erases the last character typed in and typing ’~x' erases the 
entire input line. Typing <RETURN> ends the response to these prompts. 
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Instead of a filename one can also type in a single lower-case letter (’a* 
through’t 1 ) to select a file from the current directory page. For those 
commands that present a list (menu) of possible selections, *C* for exam¬ 
ple but not ‘H’, the action is carried out immediately - no <RETURN> is 
necessary!! 

These are convenience commands. 

H (Help) vsh asks for a help subject and prints (using the internal 

paginator described below) the help file for that command, 
option or language. This uses the utility help. 

1 (display) vsh prompts for a file and displays it as ascii text. This 

is faster than a selection which calls the editor. Answer the 
prompt either with a filename or with a single character for 
selection from the current directory page. (N.B. This makes it 
hard to use vsh in directories with files that have single- 
character filenames.). The format is the same as that of the pg 
(l) program (see below). 

D (Date) Display date and time on line 24 of the screen. 

P (Process status) Call /bin/ps. Report active processes. 

W (Who) Display who is logged in. 

X (eXpr) Evaluate a mathematical expression. This is like a pocket 

calculator, vsh prompts for an expression" in the format of the 
math utility and prints the answer if the evaluation succeeds. 
Normal operators are +, •, /. J5 (modulo), - (to the power of), 

sin(), cos(). atan(), ln(), exp(). floor(), abs(), rand() (returns a 
random number between zero and its argument) and 
parentheses can be used. 

These are advanced commands. 

F (Hie) Select file by name, vsh prompts for a file name and then 

selects the specified file (which need not be on the current 
directory page). This is useful for selecting directories to per¬ 
form cd to somewhere far away (ie. where it is faster to type the 
complete file name in than it is to use V and file selection to 
get there). 

V (Vi) Select a text file for editing, vsh prompts for a file name 

and calls the default text editor on that file. This works even if 
you change the vsh default action for the selection of a text file 
(which is normally to call the editor). For browsing one often 
changes this to more or pg. 

C (Create) Create a new file, vsh prompts for a file name and 

shows a menu of file types (Text, Directory. Data. Copy. Link or 
Move). One may create text files (with the editor), directories 
(with rokdir ) or empty data files (on which zeroes will be writ¬ 
ten with a given format and size). One may also copy, link and 
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move from existing files. 

L (Is -1) Long format file listing. Next to each file, vsh displays 

protection information (access rights), alteration date and file 
size in the same manner as D or Is -1. 

K Long format listing. Next to each file vsh prints its idea of the 

file’s type in the same manner as file. This is much slower than 
’L’ because vsh has to open and read something from the begin¬ 
ning of each file to be able to determine its type. 

0 (Options) The contents of command and parameter tables are 

displayed. These control the assignments of capital-letters to 
functions as well as the file selection actions and help cards, 
vsh prompts for input lines which modify parameters or which 
create, modify or delete commands. Almost all of the com¬ 
mands and vsh functions listed here are interactively alterable 
and users can save their personalised vsh environments in their 
SSAVE/.vshrc or SHOME/.vshrc files for automatic loading upon 
entry. Typing q<KETURN> in Options Mode returns to the direc¬ 
tory page. 

T (Touch) vsh prompts for a file name and ’touches’ the file. This 

updates the file’s date of last alteration for programs that care 
or that select the newest file in a directory. 


INTERNAL PAGINATOR 

The commands T and 'H' use a simple paginator just like the one called 
pg (1). It displays text files one terminal screen at a time and waits for 
user input after each page. The last line of the screen is a prompt for 
user input. 

The commands are f (forwards) to display the next page of the file, d 
(down) to display the next half-page, b (back) to redisplay the first page 
and q (quit) to return to the vsh directory page. <RETURN> means the 
same as T. 

REMOVE MODE 

Press ’R’ to enter Remove mode. 

In Remove mode, selecting a file causes it to be marked for removal with 
two slashes. *’//" next to its file selection letter. Files selected a second 
time are unmarked (they toggle, that is). 

Pressing R a second time causes all marked files to be removed. The fol¬ 
lowing commands are available in Remove mode: 

Command Action 


<Retum> Exit Remove mode without removing marked files. 

~d Same as <Return> 


a -1 


Select corresponding file for removal, (toggle switch) 
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Select all files on current page for removal. 

Select and display another page. These commands are 
described earlier in the manual in the section on direc¬ 
tory operations. Files selected for removal on one page 
are not forgotten by moving to another page. The other 
page selection commands discussed as directory opera¬ 
tions are also available. These include ”*, *+’ and 
but not <RETURN>. 

Display help file for Remove mode. 

Remove all marked files on all pages and exit remove 
mode. If vsh cannot remove a file, it displays the reason 
and waits for a response. Press <Return> to continue 
removing marked files. Press ~d to immediately exit 
from Remove mode. 

MAKE. GREP. AND SHOWFILE 

With its interfaces to make and grep. vsh saves output messages (stdout 
and stderr) from these programs and allows one to examine the results 
in Showfile mode. From the directory page, the following commands con¬ 
trol make , grep , and showfile mode. 

G (grep) vsh prompts for a pattern and file names, and then runs 

grep in the background with these parameters, grep searches 
for the given text pattern in all listed files and reports each 
occurance with the file name and line number. The results are 
saved in the file ’.grepouf in the current directory and vsh 
beeps the terminal’s bell when finished. 

S (show) previous grep. The output of the last grep run (the file 

’.grepout’) is displayed in Showfile mode. Showfile mode com¬ 
mands are described below. 

II (make) vsh prompts for a target file (ie. the name of an entry in 

the makefile) and runs make. Execution is controlled by the 
makefile in the current directory. Output (messages from make 
and/or programs called from the ma^e process) is both 
displayed on the screen and saved in the file ’.output.’ When 
make terminates, vsh enters Showfile mode with the file ’.out¬ 
put’. 

N Make running in the background, make is run but vsh does not 

wait for termination. Output is saved in ’.output’, but is not 
displayed on the screen. When make terminates, the bell on 
your terminal rings twice. Use the E command to review the 
output in ’.output’. 

E (errors) The results of the last make (in file ’.output’) are 

displayed in Showfile mode. 

SHOWFILE MODE 

Showfile mode displays the results of the execution of make or grep. It is 
called by the ’E’ and ’S’ commands or automatically in the course of an 
’H’ command. 


0-9 


•> 
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Showfile mode is essentially a special editor, it displays a selected file 
with the lines numbered. It has commands which allow one to display 
specific portions of the file. One cannot alter the file being displayed but 
can command showfile to read and parse a line of the file. It then scans 
this line and attempts to extract a file name and line number and then 
calls the editor, starting it at the specified line. The format of the error 
messages from most compilers is simple for the showfile mode parser to 
decode. Take for example this message from the C compiler about the file 
'expr.c' 

cfl:expr.c:105: steck undefined; func. expr 

Selecting this line from a showfile page would call the editor with the file 
expr.c at line 105. 

These are the showfile commands. It is not necessary to press <Return> 
after these commands. When a complete command is sensed, it is run 
immediately. 

Command 

~P 
~e 


—<RETURN> 
<RETURN> 

q 

~d 

•> 


Action 

(for a line number) Print error file starting at 
specified line. 

Examine error line for a file name and line number. 
If they are found, run the editor on this file at the 
specified line. vsh can find (with relatively good accu¬ 
racy) file names and line numbers for error messages 
from the c, pascal and 177 compilers, grep messages and 
shell command errors. 

Same as ~e 

Display the next twenty lines. 

Leave Showfile Mode. Return to directory page. 

Same as q 

Display help file for Showfile mode. 


All commands from the directory page which might be useful are avail¬ 
able in Showfile mode. They include /, „ ., and *A’ through ’Z’ except 'L\ 
X and ’R'. 

Particularly useful are ’M’ and *G' which allow new iterations of make and 
grep, the escapes to the shell, and ’F* and ’V’, which allow one to edit files 
not found in the the error message file being shown. 

MENU MODE 

Vsh also offers a mode called menu mode which is like showfile mode 
except that the messages that are displayed are not error messages but 
shell commands with prompts and comments to explain their effects. 
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Menu mode can be entered with ‘A’ and looks for a file named '.menu' in 
the current directory or the user’s home directory. This file should be a 
list of shell commands with or without prompts and comments. Typical 
menu mode lines might look like: 

uhereis t; uhereie the binary ft doc for this command 
uc t; word count of the contents of an ascii file 

set; shou settings of shell parameters 

One can see the format of these entries. The shell command, exactly as 
you would have typed it in comes first. If menu mode is to prompt for 
parameters or completion of the command, a *S' must appear in the 
menu line where the prompted-for parameter is to be. After the com¬ 
mand. there can be a and the rest of the menu line will be ignored, it 
can be used for comments, help, explaination. etc.. 

To use menu mode, one just has to enter it (normally with ’A’) and select 
a line number from the current screen. If the selected line contains a *8', 
menu mode will prompt with the command part of the line and wait to 
read typed in input (until <RETURN>). Command lines without parame¬ 
ters (ie. without 'S’), are executed immediately. 

CONTROL COMMANDS 

The operation of vah is controled by its parameter and command tables. 
The contents of these tables can be displayed and altered with the ’6’ 
command. When vsh is invoked, it searches for the file named ’.vshrc’ in 
your save or home directorys (defines by the shell parameters SSAVE and 
8H0ME). Control comands are then read from this file, allowing one to 
create a personalized environment. 

The *0’ command also prompts for control parameters, allowing for 
interactive modification of the tables. These control parameters should 
be presented in the same lexical grammar as shell commands. Spaces 
and tabs separate tokens. Unquoted newlines terminate each statement. 

A character may be quoted by preceding it with a \. All* characters 
inside single quotes (’ *) are quoted except the single quote. Inside dou¬ 
ble quotes (" "). \ quotes another double quote and \ newline is ignored. 
Grave accents (’ *) are treated as any other character. Macros (such as 
SHOME) are not available in Options mode. 

The lexical grammar is compatible with that of the normal Unix shell. 
The grammar is somewhat different from that of csh. The file Misc/.vshrc 
in the vsh source directory contains default parameters. 

To change a parameter, type it in the format of its line in the Options 
listing, that is: 

PARAMETER-NAME PARAMETER-VALUE 
where PARAMETER—NAME can be any off the following: 


Parameter Usage 

editor Preferred editor. Loaded from shell environment param¬ 

eter 8EDIT0R or set in ’.vshrc*. See .profile. 
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make 

make program. Default is '/bin/make*. 

grep 

makerror 

g re pout 
vahhelp 

grep program. Default is '/bin/grep'. 
output file for make. Default is '.output', 
output file for grep.. Default is '.grepout*. 

Help card for ’?' command. Default is 

'/usr/lib/vsh/vshhelp'. There is also a german version 
in '/usr/src/local/help/vsh'. 

rmhelp 

showhelp 

pghelp 

debugger 

help 

ffile 

Help card for '?’ in remove mode. 

Help card for ’?' in showfile mode. 

Help card for '?’ in display mode. 

Debugger program. Default is ’/bin/adb’. 

Help program. Default is '/usr/local/help'. 

File-type program for command *K’. Default is 
'/usr/lib/vsh/ffile* (a modified version of 'file' that 
doesn’t print the newline after the file type). 

ar 

cpio 

who 

Library archiver program. Default is '/bin/ar'. 

Tape format library program. Default is ’/bin/cpio’. 

Who program. Default is ’/bin/who’. 

ps 

bsh 

Process status program Default is ’/bin/ps'. 

Bourne shell. Default is ’/bin/sh’. (Shell parameter 
SSHELL) 

csh 

root 

Twalh 

Cshell. Default is ’/usr/ucb/csh’. 

Root of the user's file system Default is ’/’. 

Mathematical expression evaluator. Default is 
’/usr/local/math’. (From F.R.Moore at C.A.R.L. at C.M.E. 
at U.C.S.D.) 

u - * 

File names for 6 extra selectable files. The user can 
assign these in his .vshrc file and access them thereafter 
with single keystrokes. They are assigned default values 
by vsh. 


To define a command, use the format: 

CHARACTER KEYWORD [PARAMETERS...] 
where CHARACTER is the character which calls the new command. 

Valid characters are A-Z and = 

These are the valid keywords. They correspond to internal functions in 
vsh 
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Keyword 

Purpose 

date 

ahowerror 

showgrep 

ahowmenu 

fUe 

Display date. Usually 'D'. 

Show errors from previous make. Usually 'E*. 

Show output from previous grep. Usually 'S'. 

Show menu from file ’.menu*. Usually ’A’. 

Select a file. If parameter is present, the parameter is 
selected using the normal criteria for automatic file 
selection. Otherwise, vsh will prompt for a file name. 
Usually ’F’. 

home 

Change to home directory. Usually (often also 

assigned to T in the .vshrc file.) 

grep 

wmake 

Run grep. vsh will prompt for parameters. Usually ’G'. 

Run make. Wait for termination and enter Showfile 
mode. Usually 'M'. 

fmake 

Run make. Do not wait for termination. Usually ’N’. 

remove 

longlist 

Enter Remove mode. Usually *R\ 

Print long format listing of files on the current page. 
Usually 'L\ 

klonglist 

Print long format listing with file type on the current 
page. Usually *K\ 

create 

vsh Enter Create Mode. Create mode has its own menu of 
file types. Usually ’C’. 

dollar 

Prompt with 'S’ and read a shell parameter for file selec¬ 
tion. Usually 'S’ and 

display 

Display the contents of a file. If no parameter is 
present, vsh will prompt for a file name. This is the vsh 
internal version of the pg command as described above. 
Usually T. 

options 

Display vsh options (parameter and command tables). 
Accept commands which modify parameters and which 
create, modify, and delete commands. If options is 
called with an argument, it will write the current con¬ 
tents on a file named ’.vshrc.new’ and EXIT IMMEDIATELY 
to allow the user to re-enter with the new init. file. 
Between exiting and re-entering, the user should move 
(with mv for example) the ’.vshrc.new’ file to ’.vshrc’ 
(after possibly saving the old copy). With this each user 
can save his vsh environment in his own initialisation 
file. He only has to set a capital letter to ’options xxx’ 
with options mode and then call this letter. It is good to 
edit the ’.vshrc.new’ file before re-entering to remove 
this setting. Usually ’O’. 

exec 

i 

Execute a program directly with the exec system call. 
The first parameter must be the program name. 
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prexec 


c allshell 


▼help 

version 
c all c shell 
null 


Directories in the user’s default parameter SPATH are 
successively searched as in the shell. Any other param¬ 
eters become parameters to the program. If it is neces¬ 
sary to search several directories for programs, to 
redirect files, to expand macros, or to expand file regu¬ 
lar expressions, use the callshell keyword instead. 

Prompt for input and run a command. The prexec 
(prompt exec) function takes 3 parameters: 

[ ll the prompt that it should print, 

2] the pathname (full or not) of the program it should 
execute and 

[3] the character ’g’ if prexec should wait for <RETURN> 
when the command is finished before returning to the 
directory page otherwise some other character other 
than ’c' which is used for prompting shells.. 

If the prompt is to contain spaces (ie. if it has more than 
one word), you must enclose it in quotes ("...”). 

If no parameter is present, an interactive shell is 
spawned. If one parameter is present, it is passed to the 
shell and run as a command. Do not specify more than 
one parameter. Instead, enclose the entire shell com¬ 
mand in quotes to provide vsh with only one parameter. 
Usually * \ 

Display the help card for vsh. Usually ’?’ from the direc¬ 
tory page. 

Tell which version of ▼sh you are using. Usually 
Like callshell only it calls the Cshell. 

Delete command. The command will no longer be active. 


DISPLAY PARAMETERS 

vsh has several switches that control the display of the directory page. 

These are different from parameters and keywords in that they have a 

specific set of possible values that are listed below. 

llist This switch can be set with values ’on’ or 'ofT and controls the 
display of the directory page. With llist 'on', vsh will display 
filenames in the format of the If command, that is, there can be 
a character after the filename that denotes the file type. Direc¬ 
tories are followed by '/’, executable files by ’•’, named pipes by 
and special files by Other file types are not noted. This 
option makes the directory display somewhat slower. 

tlist Normally vsh sorts directories alphabetically by name. When 
switch tlist is set ’on’ they will be sorted as with the Is -t com¬ 
mand, that is by date of reference with the roost recently refer¬ 
enced files comong first. This switch can also only take the 
values ’on’ and ’off*. 

ncol vsh can display up to 3 directory columns (up to 60 files) on one 
directory page. The switch ncol (number of columns) can be set 
to 1, 2 or 3 to alter this attribute. Note that only files from the 
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first (left-most) column can be selected and that successive 
columns are referenced with page number and selection letter. 

prompt This switch (when ’on’) will cause wsh to display a prompt for file 
selection (or ? for help) on each directory page. 

ENVIRONMENT PARAMETERS , t , 

▼sh takes the following parameters from the global environment: 

HOME The home directory. This parameter is automatically set 

by Unix when one logs in. 

SAVE The directory to search for ’.vshrc’. If SSAVE is not set. 

▼sh will search in SHOME. It is recommended that users 
define SSAVE as someting like 'SHOME/.save’ and move 
.profile, .vshrc, .cshrc, etc. there. 

SHELL The users login shell. Unix also sets this parameter. 

When it is necessary to escape to a shell, this parameter 
selects the program to use. 

TERM The terminal type. The terminal must be cursor 

addressable. The initialisation phase of vsh will use this 
to get the right cursor-positioning commands to work on 
your current terminal so this better be the terminal 
type you’re really at! 

See the Termcap documentation for more information about the TERM 

parameter. Other exported shell parameters can be read by vsh for 

automatic file selection with ’S’ or ’.’ as described above. 

matt. The user's mail file name, usually / usr/ mail/use r_jiame. vsh 
checks if there is new mail upon each return from a subprocess 
and will print the message ’’you have mail" if there is. 


FILES 


These are the files vsh needs and/or uses. 

SSAVE/.vshrc (or SHOME/.vshrc) Initialization file (optional). 

/etc/termcap Terminal capability database necessary for addressing 
cursor. 

.output File used to save the output of make. This file is always 

created in the current directory. 


.grepout 


File used to save the output of grep. vsh tries to first 
create this file in the working directory. If unsuccessful, 
the home directory is tried. 


File used for menu mode text. This is also first searched 
for in the current directory, then in the user’s home 
directory. 


/dev/null Null file. 

▼sh also calls the user's default shell, editor, make, grep, ffile, help, 
math... 
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EXAMPLE of a \vshrc* file 

This is an example of an initialisation file for vsh. It sets the characters 
u through z and reassigns several Capital Letters. After calling vsh I can 
perform cd /usr/src/local/win/lib with j or rm core with B. Note also 
that redundant assignments are possible (ie. ! is now the same as :) and 
that (as m P) arguments to commands are possible. 


u 

fi le 

/usr 

V 

fi le 

/usr/sar/stp/net 

u 

fi le 

/usr/include/sys 

X 

fi le 

/usr/src/local 

U 

fi le 

/usr/src/local/uln/lib 

z 

fi le 

/usr/src/1 oca1/buch 

B 

exec 

/bin/rm core 

J 

exec 

/usr/bin/readneus 

P 

exec 

/bin/ps a 

T 

prexec "whereis ; ” /usr/ucb/whsrels 

Y 

exec 

/bin/df 

2 

exec 

/bin/nai1 

! 

home 


editor 

/usr/ucb/vi 

grep 

11ist on 
ncol 1 

/bin/ejyep 

The default settings for u through z are: 

u 

file 

/usr 

V 

fi le 

/etc 

u 

file 

/usr/include 

X 

fi le 

/lib 

U 

fi le 

/usr/llb 

z 

f i le 

/usr/src 

As mentioned above, one can also place lines ! 


i*/usr/include; export i; 


in his/her '.profile' file and later select this file with *Si<RETURN>’. 

Authors 

The history of vsh is indeed colorful. This version is based on the so- 
called 'visual interpreter' that was written by Dave Scheibelhut as part of 
his thesis at U.C.Berkeley in about 1978. It was distributed as part of 
UCB’s 2.8 BSD PDP-11 Unix tape but later discontinued because of bugs 
and design problems it contained. This version was stripped down fixed 
and ported to a PDP-11 at CMRS at the University of Salzburg by Stephen 
Pope and further there developed between 1980 and 1983. Version 4.0 
was brought onto the PCS Machines and Munix 1.5 System V by STP and 
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BUGS 


Dittmnr Krall at PCS GmbH n Munich, Germany. 

Vsh has no bugs or inconsistencies whatsoever. 

It can get confused, however, by inappropriate input or by typing lots 
when it expects a little (ie. typing shell commands in without preceding 
them with <SPACE>). When this happens, typing ~C or <BREAK> will 
clear the input stream and restore some degree of order. 

In directories with more than 200 files, vsh ignores files after the 200th. 
This means the 200th in the unsorted directory list, not necessarily the 
last alphabetically. 


Unix Programmers' Manual - Vol 1 - pg(l) 

Unix Programmers’ Manual - Vol 1 - sh(l) 

• Unix Programmers' Manual - Vol 1 - csh(l) 

Unix Programmers' Manual - Vol 1 - termcap(3) 
Unix Programmers’ Manual - Vol 1 - eurses(3) 

Handbuch fuer das Unix Betriebssystem 

Stephen T. Pope, CMRS / PCS, 1983 

Chapter 8 is a long tutorial for vsh (in German). 

Introduction to the Mshell, 

Notes on Using the Mshell 4c 
vsh/msh Version 3.8 Distribution Notes 
Stephen T. Pope, CMRS, 

Cooperative fuer Computermusik, 

Universitaet Salzburg, 1981-83 
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COMMAND SUMMARY 

This is a copy of the *»h help card for the directory page. 


- Vshell - Command Summary page 1 of 4 

Directory Page Commands - No 4iETURN> necessary 
Command Action 

Q or ~d - Leave Vsh (*Q* or control-d) - return to login shell 
? - Display this help card - 4 pages - use format of *1* or pg 

a to t - Select associated file from directory page by letter 

File selection possibilities described on page 3. 

1-9. 0- Select page 1-9 within currant directory. 9 selecte page 19. 

- or * - Select previous page 

♦ xi- Select next page 

<RETURN>- Select next page 

<SPACE> - Execute temporary shell - return to vsh after 1 command 
, or f- Execute shell - to return to vsh. type to shell 

: or — Change to Home directory 

\ or ) - Change to previous (parent) directory. 

/ - Change to root directory 

Capital Letter Commands - No 43ETURN> necessary page 2 of 4 


Command 


Action 


A 

C 

0 

E 

F 

C 

H 

I 

< 

L 

n 

N 

□ 

p 

R 


- enter shoufile mode 
prompt for name ft type 


Show menu of She11 commands 
Create file or directory - 
Date and time 

Show Errors from previous make - enter ehowfile mode 

read file .output in current directory 
File selection by name - prompt for name 

Grep - search for a pattern - prompt for pattern ft files 

w'lte file .{repout 

Help - paginate online he Ipcard - prompt for subject 
Display file (text) - prompt for name or letter 

use internal paginator like pg 
Long listing - gives file type like the shell command ’file* 
Long listing - gives date of alteration like II 
Make - read makefile - prompt for entry's name 

w-lte .output - enter shoufile mode 
Make In backfy-ound (forked off) - prompt for entry*e name 

write .output - beep when finished 
Options - enter option mode 

Process status - cal I ps 

Remove files - enter remove mode 
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flora Capital Latter Commands - No 4£TURN> 


paga 3 of 4 


T 

U 

V 

u 

X 


Show output of Grep 

read 

Touch - ipdate a file 
Print flla - call Ipr 
edit (vi or aed) 


- enter showf11 a aoda 
f I la .g-epout 

- prompt for name or letter 

- prompt for name or latter 
• prompt for name or latter 


Uho la logged on - call who 
Evaluate mathematical ejqwession- 


proupt for expression 


occurs automaticalIg ipon pressing a selection letter In the current dir. 


File type selected - 


Action taken by vsh 


Text 

Executab Ie 

Directory 
Archive 
Core dump 
Other 


Execute editor on file, (vl or aed) 

Exiting the editor returns to the same page. 
Prompt for Input largv) and execute file. (a.out) 
Interactive programs take over the terminal. 
Change to lower (sub-) directory, (cd) 

List contents of archive, ar or cplo format, (ar vt) 
Prompt for object file t debug dump, (adb core) 
Return error message 


Other V6h Pages page 4 of 4 

have their own help cards viewable with ’?* from within each page. 

Oisplau Page - Use *1* for Internal paginator - like pg 

Commands: f - (forwards) - display next 21 lines of file 

RETURN>- same as T 
d - (down) - display next 15 lines 

b - (back) - go to etart of file 

q - (quit) - return to directory page 


Showfile Page 

Commands: 


- Use *E* or 'S’ to enter showflie mode for Bake or g-ep 
~e - (edit) search line for a file name and 
line number, then call editor to that point 
~«f£TURN>- same as 

*p - (print) print showfile starting at line ^ 
q - (quit) - return to directory page 
Display mode commands (b.d.f) work in Showfile mode 

Remove Page - Use *R’ then select files a throutfi t (or *) from any page. 
Press *R’ a second time to perform removal. 

Options Page - Use *0’ to view or set vsh Internal parameters. 

To change one. Just type Its name and new value, then 
<PETURN>. Type q<#ETURN> to return to directory page. 

Menu Page - Use *A* to enter menu mode - select comands from the menu 
with their line numbers. This is akin to Showfile mode. 
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NAME 

w - who is on and what they are doing 
SYNOPSIS 

w [ -h ] [ -s ] [ user ] 

DESCRIPTION 

W prints a summary of the current activity on the system, including what 
each user is doing. The heading line shows the current time of day, how 
long the system has been up. the number of users logged into the system, 
and the load averages. The load average numbers give the number of 
jobs in the run queue averaged over 1. 5 and 15 minutes. 

The fields output are: the users login name, the name of the tty the user 
is on, the time of day the user logged on, the number of minutes since 
the user last typed anything, the CPU time used by all processes and 
their children on that- terminal, the CPU time used by the currently 
active processes, the name and arguments of the current process. 

The -h flag suppresses the heading. The -s flag asks for a short form of 
output. In the short form, the tty is abbreviated, the login time and cpu 
times are left off, as are the arguments to commands. —1 gives the long 
output, which is the default. 

If a user name is included, the output will be restricted to that user. 

FILES 

/etc/utmp 

/dev/kmem 

/dev/drum 

SEE ALSO 

who(l), finger(l), ps(l) 

AUTHOR 

Mark Horton 

BUGS 

The notion of the "current process" is muddy. The current algorithm is 
"the highest numbered process on the terminal that is not ignoring 
interrupts, or, if there is none, the highest numbered process on the ter¬ 
minal". This fails, for example, in critical sections of programs like the 
shell and editor, or when faulty programs running in the background 
fork and fail to ignore interrupts. (In cases where no process can be 
found, w prints 

The CPU time is only an estimate, in particular, if someone leaves a back¬ 
ground process running after logging out, the person currently on that 
terminal is "charged" with the time. 

Background processes are not shown, even though they account for 
much of the load on the system. 

Sometimes processes, typically those in the background, are printed with 
null or garbaged arguments. In these cases, the name of the command is 
printed in parentheses. 

W does not know about the new conventions for detection of background 
jobs. It will sometimes find a background job instead of the right one. 


Page 1 


February 20, 1984 








WAIT(l) 


1IUNIX 


WAIT(l) 


NAME 

wait — await completion of process 

SYNOPSIS 

wait 

DESCRIPTION 

Wait until all processes started with Sc have completed, and report on 
abnormal terminations. 

Because the ti>aif(2) system call must be executed in the parent process, 
the Shell itself executes u»atf, without creating a new process. 

SEE ALSO 

sh(l) 

BUGS 

Not all the processes of a 3- or more-stage pipeline are children of the 
Shell, and thus can’t be waited for. 
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NAME 

wc — word count 
SYNOPSIS 

wc [ —lwc ] [ name ... ] 

DESCRIPTION 

Wc counts lines, words and characters in the named files, or in the stan¬ 
dard input if no name appears. A word is a maximal string of characters 
delimited by spaces, tabs or newlines. 

If the optional argument is present, just the specified counts (lines, 
words or characters) are selected by the letters I, w, or c. 
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NAME 

what — identify SCCS files 

SYNOPSIS 

what files 

DESCRIPTION 

What searches the given files for all occurrences of the pattern that 
get(l) substitutes for (this is ©(#) at this printing) and prints out 
what follows until the first ", >, new-line, \, or null character. For exam¬ 
ple. if the C program in file f.c contains 

char ident[] = *'©((^identification information”; 
and f.c is compiled to yield f.o and a.out, then the command 
what f.c f.o a.out 
will print 
f.c: 

identification information 


f.o: 

identification information 


a.out: 

identification information 

hhat is intended to be used in conjunction with the command get( 1), 
which automatically inserts identifying information, but it can also be 
used where the information is inserted manually. 

SEE ALSO 

get(l). help(l). 

DIAGNOSTICS 

Use help (1) for explanations. 


BUGS 

It‘s possible that an unintended occurrence of the pattern ©(#) could be 
found just by chance, but this causes no harm in nearly all cases. 
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NAME 

whatis - describe what a command is 
SYNOPSIS 

whatis command ... 

DESCRIPTION 

Whatis looks up a given command and gives the header line from the 
manual section. You can then run the man(l) command to get more 
information. If the line starts 'name(section) ...' you can do 'man section 
name’ to get the documentation for it. Try 'whatis ed' and then you 
should do 'man 1 ed’ to get the manual. 

Whatis is actually just the —f option to the man(l) command. 

FILES 

/usr/lib/whatis Data base 
SEE ALSO 

apropos(l), man(l). catman(8) 

AUTHOR 

■William Joy 
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NAME 

whereis — locate source, binary, and or manual for program 
SYNOPSIS 

whereis [ -sbm ] [ -u ] [ —SB1I dir ... -f ] name ... 

DESCRIPTION 

Wiereis locates source/binary and manuals sections for specified files. 
The supplied names are first stripped of leading pathname components 
and any (single) trailing extension of the form ".ext”, e.g. ”.c". Prefixes 
of “s.” resulting from use of source code control are also dealt with. 
Whereis then attempts to locate the desired program in a list of standard 
. places. 

You can change this list of standard places. There is a file 
"/usr/lib/whereis.dirs" which you can edit. Beware of the special line 
format used there. 

If any of the —b, —a or — m flags are given then whereis Searches only for 
binaries, sources or manual sections respectively (or any two thereof). 
The —u flag may be used to search for unusual entries. A file is said to be 
unusual if it does not have one entry of each requested type. Thus 
"whereis -m -u •" asks for those files in the current directory which have 
no documentation. 

Finally, the —B —M and —S flags may be used to change or otherwise limit 
the places where whereis searches. The xB -f file flags is used to ter¬ 
minate the last such directory list and signal the start of file names. 

EXAMPLE 

The following finds all the files in /usr/bin which are not documented in 
/usr/man/manl with source in /usr/src/cmd: 

cd /usr/ucb 

whereis —u —M /usr/man/manl —S /usr/src/cmd —f • 

FILES 

/usr/src/* 

/usr/jdoc.manj /• 

/usr/lib/whereis.dirs 

/lib. /etc, /usr/jlib,bin.ucb,old,new,local) 

AUTHOR 

William Joy 

BUGS 

Since the program uses chdir{2 ) to run faster, pathnames given with the 
~M —S and —B must be full; i.e. they must begin with a "/”. 
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NAME 


which - locate a program file including aliases and paths (csh only) 


SYNOPSIS 

which [ name ] ... 

DESCRIPTION 

Which takes a list of names and looks for the files which would be exe¬ 
cuted had these names been given as commands. Each argument is 
expanded if it is aliased, and searched for along the user’s path. Both 
aliases and path are taken from the user's .cshrc file. 


FILES 


'/.cshrc source of aliases and path values 


DIAGNOSTICS 

A diagnostic is given for names which are aliased to more than a single 
word, or if an executable file with the argument name was not found in 
the path. 


BUGS 


Only aliases and paths from ~/.cshrc are used, importing from the 
current environment is not attempted. Must be executed by a csh, since 
only csh’s know about aliases. 
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NAME 

who - who is on the system 
SYNOPSIS 

who [ —uTIpdbrtas] [ file ] 
who am i 
DESCRIPTION 

HTio can list the user's name, terminal line, login time, elapsed time since 
activity occurred on the line, and the process-ID of the command inter¬ 
preter (shell) for each current UNDC System user. It examines the 
/etc/utmp file to obtain its information. If file is given, that file is exam¬ 
ined. Usually, file will be /etc/wtmp. which contains a history of all the 
logins since the file was last created. 

H7io with the am i option identifies the invoking user. 

Except for the default —s option, the general format for output entries is: 
name [state] line time activity pid [comment] [exit] 

With options, who can list logins, logoffs, reboots, and changes to the sys¬ 
tem clock, as well as other processes spawned by the init process. These 
options are; 

—u This option lists information about those users who are currently 
logged in. The name is the user's login name. The line is the name 
of the line as found in the directory /dev. The time is the time that 
the user logged in. The activity is the number of hours and 
minutes since activity last occurred on that particular line. A dot 
(.) indicates that the terminal has seen activity in the last minute 
and is therefore "current". If more than twenty-four hours have 
elapsed or the line has not been used since boot time, the entry is 
marked old. This field is useful when trying to determine whether a 
person is working at the terminal or not. The pid is the process-ID 
of the user's shell. The commenf is the comment field associated 
with this line as found in /etc/inittab (see inittab(5)). This can 
contain information about where the terminal is located, the tele¬ 
phone number of the dataset, type of terminal if hard-wired, etc. 

-T This option causes the state of the terminal line to be printed. The 
state describes whether someone else can write to that terminal. A 
+ appears if the terminal is writable by anyone; a — appears if it is 
not. Root can write to all lines having a + or a — in the state field. 
If a bad line is encountered, a ?is printed. 

—1 This option lists only those lines on which the system is waiting for 
someone to login. The name field is LOGIN in such cases. Other 
fields are the same as for user entries except that the state field 
doesn’t exist. 

—p This option lists any other process which is currently active and 
has been previously spawned by init. The name field is the name of 
the program executed by init as found in /etc/inittab. The state, 
line, and activity fields have no meaning. The comment field shows 
the id field of the line* from /etc/inittab that spawned this process. 
See inittab( 5). 
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—d This option displays all processes that have expired and not been 

respawned by init. The exit field appears for dead processes and 
contains the termination and exit values (as returned by wait(2)), 
of the dead process. This can be useful in determining why a pro¬ 
cess terminated. 

—b This option indicates the time and date of the last reboot. 

-r This option indicates the current run-level of the init process. Fol¬ 
lowing the run-level and date information are three fields which 
indicate the current state, the number of times that state was pre¬ 
viously entered, and the previous state. 

-t This option indicates the last change to the system clock (via the 
dafe(l) command) by root. See su(l). 

—a This option processes /etc/utmp or the named file with all options 
turned on. 

-s This option is the default and lists only the name, line and time 
fields. 

FILES 

/etc/utmp 

/etc/wtmp 

/etc/inittab 

SEE ALSO 

date(l), login(l), mesg(l). su(l). wait(2), inittab(5), utmp(5). init(8). 
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NAME 

write - write to another user 

SYNOPSIS 

write user [ line ] 

DESCRIPTION 

HVife copies lines from your terminal to that of another user. When first 
called, it sends the message: 

Message from youmame (ttjr??) [ date ]... 

to the person you want to talk to. When it has successfully completed 
the connection it also sends two bells to your own terminal to indicate 
that what you are typing is being sent. 

The recipient of the message should write back at this point. Communi¬ 
cation continues until an end of file is read from the terminal or an 
interrupt is sent. At that point uHte writes EOT On the other terminal 
and exits. 

If you want to write to a user who is logged in more than once, the line 
argument may be used to indicate which line or terminal to send to (e.g., 
ttyOO); otherwise, the first instance of the user found in /etc/utmp is 
assumed and the following message posted: 

user is logged on more than bne place. 

You are connected to "terminal". 

Other locations are: 
terminal 

Permission to write may be denied or granted by use of the mesg(l) com¬ 
mand. Writing to others is normally allowed by default. Certain com¬ 
mands. in particular nro Jf{\) and jsf(l) disallow messages in order to 
prevent interference with their output. However, if the user has super- 
user permissions, messages can be forced onto a write inhibited terminal. 

If the character ! is found at the beginning of a line, write calls the shell 
to execute the rest of the line as a command. 

The following protocol is suggested for using write: when you first write 
to another user, wait lor them to write back before starting to send. 
Each person should end a messagfe with a distinctive signal (i.e., (o) for 
“over") so that the other person knows when to reply. The signal (oo) 
(for "over and out") is suggested when conversation is to be terminated. 

FILES 

/etc/utmp to find user 
/bin/sh to execute ! 

SEE ALSO 

mail(l). mesg(l), nroff(l). pr(l), sh(l), who(l). 

DIAGNOSTICS 

‘'user not logged in" if the person you are trying to write to is not logged 

in. 
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NAME 

xargs — construct argument list(s) and execute command 
SYNOPSIS 

xargs [flags] [ command [Initial-arguments] ] 

DESCRIPTION 

*orys combines the fixed initial-arguments with argument* read from 
standard input to execute the specified command one or more timer 
The number of arguments read for each command invocation and the 
manner in which they are combined are determined by the flags 
specified. • 

Cbmmand, which may be a shell file, is searched for, using one's SPATH. If 
command is omitted, /bin/echo is used. 

Arguments read in from standard input are defined to be contiguous 
strings of characters delimited by one or more blanks, tabs, or new-lines; 
empty lines are always discarded. Blanks and tabs may be embedded as 
part of an argument if escaped or quoted: Characters enclosed in quotes 
(single or double) are taken literally, and the delimiting quotes are 
removed. Outside of quoted strings a backslash (\) will escape the next 
character. 

Each argument list is constructed starting with the initial-arguments 
followed by some number of arguments read from standard input (Excep¬ 
tion. see i flag). Flags —i, —l, and ~-n determine how arguments are 
selected for each command invocation. When none of these flags are 
coded, the initial-arguments are followed by arguments read continu¬ 
ously from standard input until an internal buffer is full, and then com¬ 
mand is executed with the accumulated args. This process is repeated 
until there are no more args. When there are flag conflicts (e.g., —1 vs. 
—n). the last flag has precedence. Flag values are: 

—Inum6er Command is executed for each non-empty number 

lines of arguments from standard input. The last invo¬ 
cation of command will be with fewer lines of argu¬ 
ments if fewer than number remain. A line is con¬ 
sidered to end with the first new-line unless the last 
character of the line is a blank or a tab; a trailing 
blank/tab signals continuation through the next non¬ 
empty line. If number is omitted 1 is assumed. Option 
—x is forced. 


—ireplstr 


•n number 


Insert mode: command is executed for each line from 
standard input, taking the entire line as a single arg, 
inserting it in initial-arguments tor each occurrence 
of replstr. A maximum of 5 arguments in initial- 
arguments may each contain one or more instances of 
replstr. Blanks and tabs at the beginning of each line 
® re thrown away. Constructed arguments may not 
grow larger than 255 characters, and option -x is also 
forced. ({ is assumed for replstr if not specified. 

Execute command using as many standard input argu¬ 
ments as possible, up to number arguments maximum. 
Fewer arguments will be used if their total size is 
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-i 


~P 


—x 


—ssize 


greater than size character*, and for the la*t invoca¬ 
tion if there are fewer than number arguments 
remaining. If option -x is also coded, each number 
arguments must fit in the size limitation, else zargs 
terminates execution. 

Trace mode: The command and each constructed 
argument list are echoed to file descriptor 2 just prior 
to their execution. 

Prompt mode: The user is asked whether to execute 
command each invocation. Trace mode (-t) is turned 
on to print the command instance to be executed, fol¬ 
lowed by a ?... prompt. A reply of y (optionally fol¬ 
lowed by anything) will execute the command; any¬ 
thing else, including just a carriage return, skips that 
particular invocation of command. 

Causes zargs to terminate if any argument list would 
be greater than size characters; —x is forced by the 
options -I and -1. When neither of the options -l -l 
or -n are coded, the total length of all arguments 
must be within the size limit. 

The maximum total size of each argument list is set to 
size characters; size must be a positive integer less 
than or equal to 470. If -s is not coded. 470 is taken as 
the default. Note that the character count for size 
includes one extra character for each argument and 
the count of characters in the command name. 

Eofstr is taken as the logical end-of-ftle string. Under- 
bar (_) is assumed for the logical EOF string if is 
not coded, -e with no eofstr coded turns off the logi¬ 
cal EOF string capability (underbar is taken literally). 
Xargs reads standard input until either end-of-file or 
the logical EOF string is encountered. 

Xargs will terminate if either it receives a return code of -1 from, or if it 
cannot execute, command. When command is a shell program, it should 
explicitly exit (see sh( 1)) with an appropriate value to avoid accidentally 

returning with —1. 

EXAM The following will move all files from directory Si to directory S2. and 
echo each move command just before doing it: 

Is Si | xargs —i —t mv Sl/J{ S2/|j 

The following will combine the output of the parenthesized commands 
onto one line, which is then echoed to the end of file log. 

(logname; date; echo SO S*) | xargs >>log 
The user is asked which files in the current directory are to be archived 
and archives them into arch (1.) one at a time, or (2.) many at a time. 

1. Is | xargs -p -1 ar r arch 

2. Is | xargs -p -1 I xargs ar r arch 
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The following will execute with successive pairs of arguments ori¬ 

ginally typed as shell arguments: 

echo 8* | xargs —n2 dilT 

DIAGNOSTICS 

Self explanatory. 
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NAME 

xd — hexadecimal dump 
SYNOPSIS 

xd [ file ] [ offsetl[ . ][ b ] [ - [offset2[ .][*»]] 

DESCRIPTION 

Xd dumps file in hexadecimal and as characters. 

The file argument specifies which file is to be dumped. If no file argu¬ 
ment is specified, the standard input is used. 

The offset argument specifies the offset in the file where dumping is to 
commence. This argument is normally interpreted as hexadecimal bytes. 
If it starts with O', the offset is interpreted in octal. If V is appended, the 
offset is interpreted in decimal. If ’b’ is appended, the offset is inter¬ 
preted in blocks of 512 bytes. If the file argument is omitted, the offset 
argument must be preceded ’+’. 

If no second offset is specified, dumping continues until end-of-file. Oth¬ 
erwise dumping ends before the specified endaddress. The interpretation 
of offsets \s the same as above. 

SEE ALSO 

adb(l) 
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NAME 


xref — cross-reference listing 


SYNOPSIS 


xref [-c] [-p] [-P] 


DESCRIPTION 

Xref creates a cross-reference listing from the standard input. 

It lists on the standard output the alphabetic sorted identifiers followed 
by the linenumbers in which they appear. 

-c C comments will be skipped 
-p Pascal comments will be skipped 

-P Packed files will be processed. The filenames are prepended to the 
linenumbers. 

Unpacked input files are listed without filenames. 


EXAMPLE 


pack ack.p fac.p | xref -p -P 
outputs: 


var 

writeln 

x 


ack.p 2 fac.p 3 


y 


ack.p 12 14 fac.p 10 12 

ack.p 2 13 14 14 15 

fac.p 3 11 12 12 13 

ack.p 2 13 14 14 


SEE ALSO 


pack(l). 
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NAME 

yes — be repetitively affirmative 

SYNOPSIS 

yes [ expletive ] 

DESCRIPTION 

Yes repeatedly outputs y, or if expletive is given, that is output repeat¬ 
edly. Termination is by rubout. 

EXAMPLE 

"yes | fsck" would be the same as "fsck -y'\ 
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